pycmd-cli


Namepycmd-cli JSON
Version 4.0.3 PyPI version JSON
download
home_page
SummaryPyCmd is a command-line tool to help you manage your projects.
upload_time2023-03-25 11:49:31
maintainer
docs_urlNone
author
requires_python>=3.6
licenseMIT
keywords pycmd-cli pycmd
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <h1 align=center> PyCMD - Manage your Projects</h1>

## Contents

- [About](#what-is-pycmd)
  - [Why PyCMD?](#why-pycmd)
- [Setup](#installation)
  - [Manual Setup](#manual)
  - [Using pip](#pip)
  - [Requirements](#requirements)
- [PyCMD Commands](#commands)
- [Usage](#usage)
- [How can you help?](#contribute-)
  - [Contributers](#contributers)
- [License](#license-)
- [Frequently Asked Questions](#faqs)

## What is PyCMD?

PyCmd is a **command-line tool** to help you **manage** your **projects**. It saves you a lot of clicks. It's **simple** and **easy** to use. Interesting? [Give it a try](#installation)

### Why PyCMD?

PYCMD helps you create, manage and do cool stuff with your projects super-fast ⚡

**Here's how fast things are with PYCMD**

![](./images/Comparision-low.gif)

*forgive me for the **hamburger***

## Installation

### Pip

```console
pip install pycmd-cli
pycmd setup
```

> Make sure you have the python `lib/site-packages` added to your `PATH`

### Manual

- ⬇️ Clone the repo:

  ```console
  git clone https://www.github.com/Yasho/PyCMD.git
  ```

- ```console
  cd pycmd
  pip install .
  ```

- ⚒️ Install the requirements:

  ```console
  pip install -r requirements.txt
  ```
  
- 🔃 **Restart your terminal** for the changes to take effect

- ✅ Run the `pycmd setup` command and follow the on-screen instructions.

  ```console
  pycmd setup
  ```

> You can manually config the settings by editing the `config.json` file.
> To do so, run:
>
>  ```console
>  pycmd src
>  ```
>
> This will open the source code of pycmd. You can edit the config file located in `json/config.json`

### Requirements
>
> ⚠️ Doesn't work on Python 3.10 yet

- [Python 3.6+ (Tested on 3.9.9)](https://www.python.org/downloads/)
- [Pip](https://pypi.org/project/pip/)
- [Git](https://git-scm.com/downloads)
- [Windows](https://www.microsoft.com/en-in/windows)

[*Or if you're smart you can make it work on unix platforms ;​)*](https://www.github.com/Yasho022/Pycmd/fork)

## Commands

| Command | Description |
|---------|-------------|
| `pycmd` | Run the PyCMD command line interface. |
| `pycmd help` | Display help information. |
| `pycmd setup` | Setup PyCMD. |
| `pycmd ls` | List all projects. (Including Github repositories) |
| `pycmd open` | Open a project. |
| `pycmd rm` | Remove a project. |
| `pycmd create` | Create a new project + initialize a Git repository. |
| `pycmd src` | View and edit the source code of PYCMD |

*It's okay if you misspell the commands, PYCMD will correct them ;​-)*

## Usage

Use `pycmd` to run the command line interface.<br>
*Really?*

**Usage:**

```
pycmd <command> <parameter> -<flags> 
```

Example:

```powershell
pycmd create hello_world.py -private -y
# Creates a new python project
```

## Contribute 💖

### How do I contribute?

Thank you  for contributing to PyCMD
<!-- btw this (`​`) is zero-width space -->

Here are some ways you can help:

- [x]  Readme
- [x] Update CLI help command
- [ ] Unix Support
- [ ] New Commands

### Contributers
<!-- get a round image -->
[![](https://images.weserv.nl/?url=avatars.githubusercontent.com/u/58365481?s=50&v=4&mask=circle&fit=cover)](](https://github.com/Domin8668))

## License 🔑

PYCMD is licensed under the [MIT license](https://www.opensource.org/licenses/mit-license.php).

```license
MIT License

Copyright (c) 2022 Yasho

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (PYCMD), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

```

## FAQs

- Why did you name it **Py**CMD?

> ¯\\_\(ツ\)\_\/¯, but I think it's an **ok** name. Also `Py` represents the Python language in which PYCMD was written. Not the best name, i'm bad at keeping names.

- Why should I use PyCMD?

> PyCMD saves you a lot of time, you can use it to manage your projects if they are messy or if you want to make a lot of changes in short time. Not only that but also it will help you to make your projects more readable and maintainable.

- What are the Pros and Cons of PyCMD?

> | Pros | Cons |
> | ---- | ---- |
> | Easy to use | Might be an overkill |
> | Saves Time | Only compaitable with Windows currently |
> | Generates Boiler Plate | |
> | Easy to install/uninstall | |
> | Manages GIT | |
> | Light (Doesn't take too much space) |

- Does PyCMD collect any user data?

> No, PyCMD doesn't collect any user data. It stores the configuration in your local storage in the file `json/config.json`.

- How do you contribute to PyCMD?

> You can contribute to PyCMD by [opening an issue](https://www.github.com/Yasho022/PyCMD/issues) or by a [pull request](https://www.github.com/Yasho022/PyCMD/fork).

---

### Developer notes

If you encounter any problems feel free to [Contact me](#contact-me-)

*I heard that emojis attract attention, that's why I used them. Really sorry if you hate them, I hate them too. (i have an official rivalry towards yellow circles)*

*inspired by npm and heroku cli*

### Contact Me 💌

<a href = "https://www.reddit.com/user/Yasho022" target="_blank">
 <img src="https://img.shields.io/badge/NotYasho-ff4803?style=for-the-badge&amp;logo=reddit&amp;logoColor=white" alt = "Reddit" title="Reddit">
<a href = "https://discord.com/users/875991927210786848">
  <img src="https://img.shields.io/badge/NotYasho-6f42f5?style=for-the-badge&amp;logo=discord&amp;logoColor=white" alt = "Discord" title="Discord">

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "pycmd-cli",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "pycmd-cli,pycmd",
    "author": "",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/fb/2c/731ca0b673323ece6cc35e39a7179e2cb317ea981008e6e31c8f8bcc499d/pycmd-cli-4.0.3.tar.gz",
    "platform": null,
    "description": "<h1 align=center> PyCMD - Manage your Projects</h1>\n\n## Contents\n\n- [About](#what-is-pycmd)\n  - [Why PyCMD?](#why-pycmd)\n- [Setup](#installation)\n  - [Manual Setup](#manual)\n  - [Using pip](#pip)\n  - [Requirements](#requirements)\n- [PyCMD Commands](#commands)\n- [Usage](#usage)\n- [How can you help?](#contribute-)\n  - [Contributers](#contributers)\n- [License](#license-)\n- [Frequently Asked Questions](#faqs)\n\n## What is PyCMD?\n\nPyCmd is a **command-line tool** to help you **manage** your **projects**. It saves you a lot of clicks. It's **simple** and **easy** to use. Interesting? [Give it a try](#installation)\n\n### Why PyCMD?\n\nPYCMD helps you create, manage and do cool stuff with your projects super-fast \u26a1\n\n**Here's how fast things are with PYCMD**\n\n![](./images/Comparision-low.gif)\n\n*forgive me for the **hamburger***\n\n## Installation\n\n### Pip\n\n```console\npip install pycmd-cli\npycmd setup\n```\n\n> Make sure you have the python `lib/site-packages` added to your `PATH`\n\n### Manual\n\n- \u2b07\ufe0f Clone the repo:\n\n  ```console\n  git clone https://www.github.com/Yasho/PyCMD.git\n  ```\n\n- ```console\n  cd pycmd\n  pip install .\n  ```\n\n- \u2692\ufe0f Install the requirements:\n\n  ```console\n  pip install -r requirements.txt\n  ```\n  \n- \ud83d\udd03 **Restart your terminal** for the changes to take effect\n\n- \u2705 Run the `pycmd setup` command and follow the on-screen instructions.\n\n  ```console\n  pycmd setup\n  ```\n\n> You can manually config the settings by editing the `config.json` file.\n> To do so, run:\n>\n>  ```console\n>  pycmd src\n>  ```\n>\n> This will open the source code of pycmd. You can edit the config file located in `json/config.json`\n\n### Requirements\n>\n> \u26a0\ufe0f Doesn't work on Python 3.10 yet\n\n- [Python 3.6+ (Tested on 3.9.9)](https://www.python.org/downloads/)\n- [Pip](https://pypi.org/project/pip/)\n- [Git](https://git-scm.com/downloads)\n- [Windows](https://www.microsoft.com/en-in/windows)\n\n[*Or if you're smart you can make it work on unix platforms ;\u200b)*](https://www.github.com/Yasho022/Pycmd/fork)\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `pycmd` | Run the PyCMD command line interface. |\n| `pycmd help` | Display help information. |\n| `pycmd setup` | Setup PyCMD. |\n| `pycmd ls` | List all projects. (Including Github repositories) |\n| `pycmd open` | Open a project. |\n| `pycmd rm` | Remove a project. |\n| `pycmd create` | Create a new project + initialize a Git repository. |\n| `pycmd src` | View and edit the source code of PYCMD |\n\n*It's okay if you misspell the commands, PYCMD will correct them ;\u200b-)*\n\n## Usage\n\nUse `pycmd` to run the command line interface.<br>\n*Really?*\n\n**Usage:**\n\n```\npycmd <command> <parameter> -<flags> \n```\n\nExample:\n\n```powershell\npycmd create hello_world.py -private -y\n# Creates a new python project\n```\n\n## Contribute \ud83d\udc96\n\n### How do I contribute?\n\nThank you  for contributing to PyCMD\n<!-- btw this (`\u200b`) is zero-width space -->\n\nHere are some ways you can help:\n\n- [x]  Readme\n- [x] Update CLI help command\n- [ ] Unix Support\n- [ ] New Commands\n\n### Contributers\n<!-- get a round image -->\n[![](https://images.weserv.nl/?url=avatars.githubusercontent.com/u/58365481?s=50&v=4&mask=circle&fit=cover)](](https://github.com/Domin8668))\n\n## License \ud83d\udd11\n\nPYCMD is licensed under the [MIT license](https://www.opensource.org/licenses/mit-license.php).\n\n```license\nMIT License\n\nCopyright (c) 2022 Yasho\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (PYCMD), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n```\n\n## FAQs\n\n- Why did you name it **Py**CMD?\n\n> \u00af\\\\_\\(\u30c4\\)\\_\\/\u00af, but I think it's an **ok** name. Also `Py` represents the Python language in which PYCMD was written. Not the best name, i'm bad at keeping names.\n\n- Why should I use PyCMD?\n\n> PyCMD saves you a lot of time, you can use it to manage your projects if they are messy or if you want to make a lot of changes in short time. Not only that but also it will help you to make your projects more readable and maintainable.\n\n- What are the Pros and Cons of PyCMD?\n\n> | Pros | Cons |\n> | ---- | ---- |\n> | Easy to use | Might be an overkill |\n> | Saves Time | Only compaitable with Windows currently |\n> | Generates Boiler Plate | |\n> | Easy to install/uninstall | |\n> | Manages GIT | |\n> | Light (Doesn't take too much space) |\n\n- Does PyCMD collect any user data?\n\n> No, PyCMD doesn't collect any user data. It stores the configuration in your local storage in the file `json/config.json`.\n\n- How do you contribute to PyCMD?\n\n> You can contribute to PyCMD by [opening an issue](https://www.github.com/Yasho022/PyCMD/issues) or by a [pull request](https://www.github.com/Yasho022/PyCMD/fork).\n\n---\n\n### Developer notes\n\nIf you encounter any problems feel free to [Contact me](#contact-me-)\n\n*I heard that emojis attract attention, that's why I used them. Really sorry if you hate them, I hate them too. (i have an official rivalry towards yellow circles)*\n\n*inspired by npm and heroku cli*\n\n### Contact Me \ud83d\udc8c\n\n<a href = \"https://www.reddit.com/user/Yasho022\" target=\"_blank\">\n <img src=\"https://img.shields.io/badge/NotYasho-ff4803?style=for-the-badge&amp;logo=reddit&amp;logoColor=white\" alt = \"Reddit\" title=\"Reddit\">\n<a href = \"https://discord.com/users/875991927210786848\">\n  <img src=\"https://img.shields.io/badge/NotYasho-6f42f5?style=for-the-badge&amp;logo=discord&amp;logoColor=white\" alt = \"Discord\" title=\"Discord\">\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "PyCmd is a command-line tool to help you manage your projects.",
    "version": "4.0.3",
    "split_keywords": [
        "pycmd-cli",
        "pycmd"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "50a4dd324c5174f5608a2eb96bf83895ed80b96af79e517d93b541ae922d6a7a",
                "md5": "06e6428f49f7986d9047ada12d68f7d5",
                "sha256": "c15e1bbe7e64838d6e2925db1fb7486be621bb68a5cc9bc91c2f3d8c20613536"
            },
            "downloads": -1,
            "filename": "pycmd_cli-4.0.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "06e6428f49f7986d9047ada12d68f7d5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 21580,
            "upload_time": "2023-03-25T11:49:29",
            "upload_time_iso_8601": "2023-03-25T11:49:29.131506Z",
            "url": "https://files.pythonhosted.org/packages/50/a4/dd324c5174f5608a2eb96bf83895ed80b96af79e517d93b541ae922d6a7a/pycmd_cli-4.0.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "fb2c731ca0b673323ece6cc35e39a7179e2cb317ea981008e6e31c8f8bcc499d",
                "md5": "5bb499e00e7f8f8ce067bdea02168d86",
                "sha256": "a39110f70ddd18d4ed5206649f1f002528429c1e1152323f80bc59ea47c8b8e6"
            },
            "downloads": -1,
            "filename": "pycmd-cli-4.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "5bb499e00e7f8f8ce067bdea02168d86",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 19462,
            "upload_time": "2023-03-25T11:49:31",
            "upload_time_iso_8601": "2023-03-25T11:49:31.776857Z",
            "url": "https://files.pythonhosted.org/packages/fb/2c/731ca0b673323ece6cc35e39a7179e2cb317ea981008e6e31c8f8bcc499d/pycmd-cli-4.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-03-25 11:49:31",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "pycmd-cli"
}
        
Elapsed time: 0.06325s