Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
74 changes: 72 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,72 @@
# Platy.AdventureWorks.Entities
Entities related to the AdventureWorks2022 database.
# Data API Builder Entity generator

This is a dotnet tool generates the [data-api-builder](https://learn.microsoft.com/en-us/azure/data-api-builder/) data-api-builder configuration file with the entites from an existing database.

** This is currently alpha release **

## Installation
`dotnet tool install --global DbApiBuilderEntityGenerator --version 1.0.3-alpha`
## Usage

### Command

`dab-entity-gen -p SqlServer -c Data Source=localhost;Initial Catalog=pubs;User ID=sa;Password=Passw0rd1;Encrypt=False`

### Configuration file

Sample Configuration file:

```yaml
# the connection string to the database
connectionString: "Data Source=(local);Initial Catalog=Tracker;Integrated Security=True"

# the database provider name. Default:SqlServer
provider: SqlServer

# config name to read the connection string from the user secrets file
connectionName: "ConnectionStrings:Generator"

# the user secret identifier, can be shared with .net core project
userSecretsId: "984ef0cf-2b22-4fd1-876d-e01499da4c1f"

# the directory to output the configuration. Default is current.
outputDirectory: .\

# tables to include or empty to include all
tables:
- Priority
- Status
- Task
- User

# schemas to include or empty to include all
schemas:
- dbo

# exclude tables or columns
exclude:
# list of expressions for tables to exclude, source is Schema.TableName
tables:
- exact: dbo.SchemaVersions
- regex: dbo\.SchemaVersions$
# list of expressions for columns to exclude, source is Schema.TableName.ColumnName
columns:
- exact: dbo.SchemaVersions\.Version
- regex: dbo\.SchemaVersions\.Version$

# how to generate entity class names from the table name. Preserve|Plural|Singular. Default: Singular
entityNaming: Singular

# how to generate relationship collections names for the entity. Default: Plural
relationshipNaming: Plural

# Rename entities and properties with regular expressions. Matched expressions will be removed.
renaming:
entities:
- ^(sp|tbl|udf|vw)_
properties:
- ^{Table.Name}(?=Id|Name)

#templateFilePath: ./template/dab-config1.csx

```
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<RepositoryType>git</RepositoryType>
<RepositoryUrl>https://github.com/platyscript/DbApiBuilderEntityGenerator</RepositoryUrl>
<PublishRepositoryUrl>true</PublishRepositoryUrl>
<Version>1.0.2-alpha</Version>
<Version>1.0.3-alpha</Version>
<PackageReleaseNotes>
* Net9
</PackageReleaseNotes>
Expand Down
Loading