repos


Namerepos JSON
Version 0.2.0 PyPI version JSON
download
home_page
SummaryManages git repos inside a directory
upload_time2024-01-19 18:34:25
maintainer
docs_urlNone
authorjpedro
requires_python
licenseMIT
keywords git repos
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Repos

[![PyPI version](https://badge.fury.io/py/repos.svg)](https://badge.fury.io/py/repos)
[![Unstable package](https://img.shields.io/badge/_Unstable_package_-_This_code_is_a_work_in_progress_-red)](https://semver.org)


Manage your git repos.


## Install

    pip install repos


## Usage

Inside a directory with several git repos run:

    $ repos
    Repos in /Users/hello/repos

    STATUS              NAME                            BRANCH
    ────────────────    ────────────────────────────    ──────────
    •   •  1↑  •  •     this-is-a-ahead-repo              master
    •  1↓   •  •  •     this-is-a-behind-repo             master
    •   •   •  •  •     this-is-a-clean-repo              master
                        this-is-a-directory/
    1±      ⚑  •  •     this-is-a-dirty-repo              master
    •   ⚑         •     this-repo-has-no-remotes          master
    •   •   •  •  3     this-repo-has-three-branches      branch-3
    •   •   •  2  •     this-repo-has-two-remotes         master

            1 directories
            1 without a remote ⚑
            1 without upstream ⚑
            1 changed
            1 behind
            1 ahead
            4 clean

To check all available commands:

```
$ repos help
NAME
    repos —  Manages your git repos

USAGE
    repos                       # Lists all repos in text format
    repos export --json         # Exports all repos as json
    repos export --yaml         # Exports all repos as yaml
    repos show REPO             # Shows the repo details
    repos save                  # Commits local changes
    repos push                  # Pushes up to the upstream
    repos pull                  # Pulls from the upstream
    repos sync                  # Pull from the upstream and pushes up
    repos help                  # Shows this help
    repos version               # Prints the current version
```


## Todos

- [ ] Show by default only repos with issues.

- [ ] Show all with the `-a | --all` flag.

- [ ] Add `clone <url>` command to clone a git repo.

- [ ] Add `export [file]` command to dump all repos, branches
      and remotes into a file (by default `repos.yaml`).

- [ ] Add `import [file]` command to clone repos, branches
      and remotes from a file (by default `repos.yaml`).

- [x] Add `config [repo1,repo2] [key] [value]` subcommand to
      store settings in the `.git/repo.yaml` file.

- [ ] Add `save [repo1,repo2]` subcommand to commit all
      changes.

- [ ] Add `pull [repo1,repo2]` subcommand to pull all the
      latest commits from the upstream.

- [ ] Add `sync [repo1,repo2]` subcommand to commits all
      changes, pull the latest commits, and push local commits
      to the upstream.

- [ ] Code the `enabled` config to turn off all other configs.

- [ ] Customise the colours via env vars.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "repos",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "git repos",
    "author": "jpedro",
    "author_email": "jpedro.barbosa@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/3b/8d/c1169c0fcbb6f1de36b58e1afac2c8521082f71cd7a11e645767aa8b2221/repos-0.2.0.tar.gz",
    "platform": null,
    "description": "# Repos\n\n[![PyPI version](https://badge.fury.io/py/repos.svg)](https://badge.fury.io/py/repos)\n[![Unstable package](https://img.shields.io/badge/_Unstable_package_-_This_code_is_a_work_in_progress_-red)](https://semver.org)\n\n\nManage your git repos.\n\n\n## Install\n\n    pip install repos\n\n\n## Usage\n\nInside a directory with several git repos run:\n\n    $ repos\n    Repos in /Users/hello/repos\n\n    STATUS              NAME                            BRANCH\n    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    \u2022   \u2022  1\u2191  \u2022  \u2022     this-is-a-ahead-repo              master\n    \u2022  1\u2193   \u2022  \u2022  \u2022     this-is-a-behind-repo             master\n    \u2022   \u2022   \u2022  \u2022  \u2022     this-is-a-clean-repo              master\n                        this-is-a-directory/\n    1\u00b1      \u2691  \u2022  \u2022     this-is-a-dirty-repo              master\n    \u2022   \u2691         \u2022     this-repo-has-no-remotes          master\n    \u2022   \u2022   \u2022  \u2022  3     this-repo-has-three-branches      branch-3\n    \u2022   \u2022   \u2022  2  \u2022     this-repo-has-two-remotes         master\n\n            1 directories\n            1 without a remote \u2691\n            1 without upstream \u2691\n            1 changed\n            1 behind\n            1 ahead\n            4 clean\n\nTo check all available commands:\n\n```\n$ repos help\nNAME\n    repos \u2014  Manages your git repos\n\nUSAGE\n    repos                       # Lists all repos in text format\n    repos export --json         # Exports all repos as json\n    repos export --yaml         # Exports all repos as yaml\n    repos show REPO             # Shows the repo details\n    repos save                  # Commits local changes\n    repos push                  # Pushes up to the upstream\n    repos pull                  # Pulls from the upstream\n    repos sync                  # Pull from the upstream and pushes up\n    repos help                  # Shows this help\n    repos version               # Prints the current version\n```\n\n\n## Todos\n\n- [ ] Show by default only repos with issues.\n\n- [ ] Show all with the `-a |\u00a0--all` flag.\n\n- [ ] Add `clone <url>` command to clone a git repo.\n\n- [ ] Add `export [file]` command to dump all repos, branches\n      and remotes into a file (by default `repos.yaml`).\n\n- [ ] Add `import [file]` command to clone repos, branches\n      and remotes from a file (by default `repos.yaml`).\n\n- [x] Add `config [repo1,repo2] [key] [value]` subcommand to\n      store settings in the `.git/repo.yaml` file.\n\n- [ ] Add `save [repo1,repo2]` subcommand to commit all\n      changes.\n\n- [ ] Add `pull [repo1,repo2]` subcommand to pull all the\n      latest commits from the upstream.\n\n- [ ] Add `sync [repo1,repo2]` subcommand to commits all\n      changes, pull the latest commits, and push local commits\n      to the upstream.\n\n- [ ] Code the `enabled` config to turn off all other configs.\n\n- [ ] Customise the colours via env vars.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Manages git repos inside a directory",
    "version": "0.2.0",
    "project_urls": null,
    "split_keywords": [
        "git",
        "repos"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3b8dc1169c0fcbb6f1de36b58e1afac2c8521082f71cd7a11e645767aa8b2221",
                "md5": "567fdad4547b73d128db70bb812fa344",
                "sha256": "dcaf005be9f5b11c13a37eb851d8c9feba3541d70e8122c5b53adb21d326f11b"
            },
            "downloads": -1,
            "filename": "repos-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "567fdad4547b73d128db70bb812fa344",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 15173,
            "upload_time": "2024-01-19T18:34:25",
            "upload_time_iso_8601": "2024-01-19T18:34:25.698285Z",
            "url": "https://files.pythonhosted.org/packages/3b/8d/c1169c0fcbb6f1de36b58e1afac2c8521082f71cd7a11e645767aa8b2221/repos-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-19 18:34:25",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "repos"
}
        
Elapsed time: 1.25571s