plasticscm-statistics


Nameplasticscm-statistics JSON
Version 0.0.14 PyPI version JSON
download
home_pagehttps://github.com/bootloader-studio/cli-plasticscm-statistics.git
SummaryPython command line library to generate Plastic SCM activities reports
upload_time2023-12-08 13:48:32
maintainer
docs_urlNone
authorDaniel CAUNE
requires_python>=3.9,<4.0
licenseSEE LICENSE IN <LICENSE.md>
keywords library cli commit changeset plasticscm statistics
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Plastic SCM Repository Activities Reporting
Python command line library to generate Plastic SCM repository activities reports.

## Usage

### Prerequisite
Our command line utility relies on the following other utilities:
- [`cm`](https://docs.plasticscm.com/cli/plastic-scm-version-control-cli-guide): Plastic SCM command line.
- [`diff`](https://man.cx/diff): Unix utility that computes and displays the differences between the contents of files
- [`diffstat`](https://man.cx/diffstat): Unix utility that provides statistics based on the output of diff.

Make sure that you have configured Plastic SCM client application so that it uses the Unix command-line utility `diff` for comparing text files.  This setting needs to be written in the Plastic SCM client application's configuration file `$USER/.plastic4/client.conf`:

```xml
<DiffTools>
  <DiffToolData>
    <FileType>enTextFile</FileType>
    <FileExtensions>*</FileExtensions>
    <Tools>
      <string>/usr/bin/diff -u "@sourcefile" "@destinationfile"</string>
    </Tools>
  </DiffToolData>
  ...
</DiffTools>
```

### Installation
```shell
pip install plasticscm-statistics
```

### Execution

```shell
usage: cmstats [-h] [--end-time ISO8601] [--logging-level LEVEL] [--server NAME] [-o PATH]
               [--start-time ISO8601]

Plastic SCM repository activities reporting

options:
  -h, --help            show this help message and exit
  --end-time ISO8601
                        specify the latest date of changesets to return. This date is exclusive, so changesets that
                        were made at this date are not returned.
  --logging-level LEVEL
                        specify the logging level (critical, error, warning, info, debug)
  --server NAME         specify the Plastic SCM server to connect to
  -o PATH, --output-file PATH
                        specify the path and name of the file to write in the activity statistics of the Plastic SCM
                        repositories
  --start-time ISO8601
                        specify the earliest date of changesets to return. This date is inclusive, so changesets that
                        were made at this date are returned.
```
            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/bootloader-studio/cli-plasticscm-statistics.git",
    "name": "plasticscm-statistics",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9,<4.0",
    "maintainer_email": "",
    "keywords": "library,cli,commit,changeset,plasticscm,statistics",
    "author": "Daniel CAUNE",
    "author_email": "daniel@bootloader.studio",
    "download_url": "https://files.pythonhosted.org/packages/63/b4/2005017d999c9b17bf61753b2ca6d0bedc2029853685faaed25bed9fa9c7/plasticscm_statistics-0.0.14.tar.gz",
    "platform": null,
    "description": "# Plastic SCM Repository Activities Reporting\nPython command line library to generate Plastic SCM repository activities reports.\n\n## Usage\n\n### Prerequisite\nOur command line utility relies on the following other utilities:\n- [`cm`](https://docs.plasticscm.com/cli/plastic-scm-version-control-cli-guide): Plastic SCM command line.\n- [`diff`](https://man.cx/diff): Unix utility that computes and displays the differences between the contents of files\n- [`diffstat`](https://man.cx/diffstat): Unix utility that provides statistics based on the output of diff.\n\nMake sure that you have configured Plastic SCM client application so that it uses the Unix command-line utility `diff` for comparing text files.  This setting needs to be written in the Plastic SCM client application's configuration file `$USER/.plastic4/client.conf`:\n\n```xml\n<DiffTools>\n  <DiffToolData>\n    <FileType>enTextFile</FileType>\n    <FileExtensions>*</FileExtensions>\n    <Tools>\n      <string>/usr/bin/diff -u \"@sourcefile\" \"@destinationfile\"</string>\n    </Tools>\n  </DiffToolData>\n  ...\n</DiffTools>\n```\n\n### Installation\n```shell\npip install plasticscm-statistics\n```\n\n### Execution\n\n```shell\nusage: cmstats [-h] [--end-time ISO8601] [--logging-level LEVEL] [--server NAME] [-o PATH]\n               [--start-time ISO8601]\n\nPlastic SCM repository activities reporting\n\noptions:\n  -h, --help            show this help message and exit\n  --end-time ISO8601\n                        specify the latest date of changesets to return. This date is exclusive, so changesets that\n                        were made at this date are not returned.\n  --logging-level LEVEL\n                        specify the logging level (critical, error, warning, info, debug)\n  --server NAME         specify the Plastic SCM server to connect to\n  -o PATH, --output-file PATH\n                        specify the path and name of the file to write in the activity statistics of the Plastic SCM\n                        repositories\n  --start-time ISO8601\n                        specify the earliest date of changesets to return. This date is inclusive, so changesets that\n                        were made at this date are returned.\n```",
    "bugtrack_url": null,
    "license": "SEE LICENSE IN <LICENSE.md>",
    "summary": "Python command line library to generate Plastic SCM activities reports",
    "version": "0.0.14",
    "project_urls": {
        "Homepage": "https://github.com/bootloader-studio/cli-plasticscm-statistics.git",
        "Repository": "https://github.com/bootloader-studio/cli-plasticscm-statistics.git"
    },
    "split_keywords": [
        "library",
        "cli",
        "commit",
        "changeset",
        "plasticscm",
        "statistics"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0bd9abf8fc3dcd290bf003459fe4400ca6ada1f5d80695065b85f5cae8f66d05",
                "md5": "56648820e01c1dd909609be8d7587b27",
                "sha256": "a0ca1d2dbf0a17f7367966a2269b5def5e63971a8679c84efcca98bd795f67db"
            },
            "downloads": -1,
            "filename": "plasticscm_statistics-0.0.14-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "56648820e01c1dd909609be8d7587b27",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9,<4.0",
            "size": 14957,
            "upload_time": "2023-12-08T13:48:30",
            "upload_time_iso_8601": "2023-12-08T13:48:30.663003Z",
            "url": "https://files.pythonhosted.org/packages/0b/d9/abf8fc3dcd290bf003459fe4400ca6ada1f5d80695065b85f5cae8f66d05/plasticscm_statistics-0.0.14-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "63b42005017d999c9b17bf61753b2ca6d0bedc2029853685faaed25bed9fa9c7",
                "md5": "2ba098dd9cc18e36778a453dacfe19dc",
                "sha256": "72decb65fccf7ea9f9166fdd59dc83783274969799cf7900ab747c99ecfb0628"
            },
            "downloads": -1,
            "filename": "plasticscm_statistics-0.0.14.tar.gz",
            "has_sig": false,
            "md5_digest": "2ba098dd9cc18e36778a453dacfe19dc",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9,<4.0",
            "size": 10253,
            "upload_time": "2023-12-08T13:48:32",
            "upload_time_iso_8601": "2023-12-08T13:48:32.016989Z",
            "url": "https://files.pythonhosted.org/packages/63/b4/2005017d999c9b17bf61753b2ca6d0bedc2029853685faaed25bed9fa9c7/plasticscm_statistics-0.0.14.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-12-08 13:48:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bootloader-studio",
    "github_project": "cli-plasticscm-statistics",
    "github_not_found": true,
    "lcname": "plasticscm-statistics"
}
        
Elapsed time: 0.35747s