Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/EasyAbp/AbpHelper.CLI

Providing code generation and more features to help you develop applications and modules with the ABP framework.
https://github.com/EasyAbp/AbpHelper.CLI

Last synced: 3 months ago
JSON representation

Providing code generation and more features to help you develop applications and modules with the ABP framework.

Host: GitHub
URL: https://github.com/EasyAbp/AbpHelper.CLI
Owner: EasyAbp
License: mit
Created: 2020-01-19T06:22:37.000Z (about 5 years ago)
Default Branch: develop
Last Pushed: 2024-10-27T18:01:01.000Z (3 months ago)
Last Synced: 2024-10-27T23:55:48.118Z (3 months ago)
Language: C#
Homepage:
Size: 13.1 MB
Stars: 283
Watchers: 17
Forks: 94
Open Issues: 33
Metadata Files:
- Readme: docs/README.md
- License: LICENSE

Awesome Lists containing this project

awesome-abp - AbpHelper.CLI - Providing code generation and more features to help you develop applications and modules with the ABP framework. (Tools / Community)

README

        # AbpHelper.CLI

[![ABP version](https://img.shields.io/badge/dynamic/xml?style=flat-square&color=yellow&label=abp&query=%2F%2FProject%2FPropertyGroup%2FAbpVersion&url=https%3A%2F%2Fraw.githubusercontent.com%2FEasyAbp%2FAbpHelper.CLI%2Fmaster%2FDirectory.Build.props)](https://abp.io)

[![NuGet](https://img.shields.io/nuget/v/EasyAbp.AbpHelper.svg?style=flat-square)](https://www.nuget.org/packages/EasyAbp.AbpHelper)

[![NuGet Download](https://img.shields.io/nuget/dt/EasyAbp.AbpHelper.svg?style=flat-square)](https://www.nuget.org/packages/EasyAbp.AbpHelper)

[![Discord online](https://badgen.net/discord/online-members/xyg8TrRa27?label=Discord)](https://discord.gg/xyg8TrRa27)

[![GitHub stars](https://img.shields.io/github/stars/EasyAbp/AbpHelper.CLI?style=social)](https://www.github.com/EasyAbp/AbpHelper.CLI)

AbpHelper is a tool that help you with developing Abp vNext applications.

**Make sure to backup your source files before using it!**

## Getting Started

1. Install AbpHelper CLI tool

    `dotnet tool install EasyAbp.AbpHelper -g`

    > If you prefer GUI, there is also a tool with a fancy UI: [AbpHelper.GUI](https://github.com/EasyAbp/AbpHelper.GUI)

1. If you have previously installed it, update it with the following command:

    `dotnet tool update EasyAbp.AbpHelper -g`

1. Use [ABP CLI](https://docs.abp.io/en/abp/latest/CLI) to create an ABP application

    `abp new MyToDo`

1. Create an entity

    ``` csharp

    public class Todo : FullAuditedEntity

    {

        public string Content { get; set; }

        public bool Done { get; set; }

    }

    ```

1. Run AbpHelper

    `abphelper generate crud Todo -d C:\MyTodo`

    * `generate crud` is a sub command to generate CRUD files

    * `Todo` specified the entity name we created earlier

    * `-d` specified the **root** directory of the ABP project, which is created by the ABP CLI

    AbpHelper will generate all the CRUD stuffs , even include adding migration and database updating!

1. Run the `DbMigrator` to seed the database

1. Startup your application

1. Login with the default admin account, and see the magic happens!

    ![running_demo](/docs/images/2020-02-10-14-09-22.png)

    > If you don't see the TODO menu, check your permissions and make sure the TODO related permissions are granted

## Usage

* Run `abphelper -h` to see the general help

* Similarly, you can use `-h` or `--help` option to see detailed usage of each of the following commands

### Commands

* generate

  Generate files for ABP projects. See 'abphelper generate --help' for details

  * crud

    Generate a set of CRUD related files according to the specified entity

    [Demo GIF](/docs/images/crud.gif)

  * service

    Generate service interface and class files according to the specified name

    [Demo GIF](/docs/images/service.gif)

  * methods

    Generate service method(s) according to the specified name(s)

    [Demo GIF](/docs/images/methods.gif)

  * localization

    Generate localization item(s) according to the specified name(s)

    [Demo GIF](/docs/images/localization.gif)

  * controller

    Generate controller class and methods according to the specified service

    [Demo GIF](/docs/images/controller.gif)

* ef

  A shortcut to run 'dotnet ef' commands. See 'abphelper ef --help' for details

  [Demo GIF](/docs/images/ef.gif)

* module

  Help quickly add/update/remove ABP modules. See 'abphelper module --help' for details

  [Demo GIF](/docs/images/module.gif)