# Sculptor

**Repository Path**: mirrors/sculptor

## Basic Information

- **Project Name**: Sculptor
- **Description**: Sculptor 是一个简单但功能强大的代码生成平台，该平台提供了一个Quick Start来实现模型驱动软件开发(MDSD)。 Sculptor让你只需关心业务需求，而不是详细技术。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 0
- **Created**: 2017-04-01
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: code-generator

**Tags**: None

## README

# Work in progress
Sculptor is moving to new XText, Java, Spring, Hibernate, ... . [Old 3.2.0 version](https://github.com/sculptor/sculptor/tree/v3.2.0) is in separate branch. Develop branch is moving forward.

# [![Sculptor](https://raw.github.com/sculptor/sculptor.github.io/master/images/sculptor-banner.png)](https://sculptor.github.io)  [![Build Status](https://travis-ci.org/sculptor/sculptor.png?branch=develop)](https://travis-ci.org/sculptor/sculptor) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.sculptorgenerator/sculptor-maven-plugin/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.sculptorgenerator/sculptor-maven-plugin/) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/sculptor/sculptor?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) #


[Sculptor](http://sculptor.github.io) is an open source productivity tool that applies the concepts from [Domain-Driven Design](http://domaindrivendesign.org/books/) and [Domain Specific Languages](http://en.wikipedia.org/wiki/Domain-specific_language).

You express your design intent in a textual specification (within an [Eclipse editor](http://sculptor.github.io/documentation/eclipse-plugin)), from which Sculptor generates (with a [Maven plugin](http://sculptor.github.io/documentation/maven-plugin)) high quality
Java code and configuration. You can use the concepts from Domain-Driven Design (DDD) in the textual Domain Specific Language (DSL).
E.g. Service, Module, Entity, Value Object, Repository.

The generated code is based on well-known frameworks, such as [JPA](http://java.sun.com/javaee/technologies/persistence.jsp),
[Hibernate](http://www.hibernate.org/), [Spring Framework](http://www.springframework.org/) or [Java EE](http://java.sun.com/javaee/).
Sculptor takes care of the technical details, the tedious repetitive work, and let you focus on delivering more business value - and have more fun.

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->


- [System Requirements](#system-requirements)
- [Installation](#installation)
- [Getting started](#getting-started)
- [Contributing](#contributing)
- [License](#license)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->


## System Requirements

To use Sculptor you need local installations of the following tools:

* [Java JDK](http://www.oracle.com/technetwork/java/javase/downloads/) (17)
* [Maven](http://maven.apache.org/download.html) (3.9.9 or newer)
* [Eclipse](http://eclipse.org/downloads/) (XXX or newer) with [Xtext](http://www.eclipse.org/Xtext/download.html) (2.38.0 or newer)
* (optional) [GraphViz](http://www.graphviz.org/) (2.2.8 or newer)

The installation and configuration of these tools is described in [Sculptors installation guide](http://sculptor.github.io/documentation/installation).


## Installation

Sculptor consists of an [Eclipse plugin](http://sculptor.github.io/documentation/eclipse-plugin) (the DSL editor) and a [Maven plugin](http://sculptor.github.io/documentation/maven-plugin) (the code generator) with its [Maven archetypes](http://sculptor.github.io/documentation/maven-archetypes):

* Sculptors Eclipse plugin has to be installed with the Eclipse Update Manager `Help > Install New Software...` from [http://sculptor.github.io/updates/](http://sculptor.github.io/updates/)
* Sculptors Maven plugin and its Maven archetypes are retrieved by Maven from one of the following Maven repositories
 * Releases: [Maven Central](http://search.maven.org)
 * Development Snapshots: [https://oss.sonatype.org/content/repositories/snapshots/](https://oss.sonatype.org/content/repositories/snapshots/)

The installation and configuration of these tools is described in [Sculptors installation guide](http://sculptor.github.io/documentation/installation).


## Getting started

To start with a hands-on example on using Sculptor use the
[Hello Word Tutorial](http://sculptor.github.io/documentation/hello-world-tutorial). There're other tutorials to continue with, e.g.
the [DDD Sample](http://sculptor.github.io/documentation/ddd-sample),
the [Archetype Tutorial](http://sculptor.github.io/documentation/archetype-tutorial)
or the [Advanced Tutorial](http://sculptor.github.io/documentation/advanced-tutorial).

You can learn more about the capabilities of Sculptor by reading the [blog posts](http://sculptor.github.io/archive), e.g. 
[Improving Developer Productivity with Sculptor](http://sculptor.github.io/2010/06/10/improving-developer-productivity-with-sculptor).


## Contributing

Here are some ways for you to contribute:

* Get involved with the community on the [Sculptor forum](https://groups.google.com/group/sculptorgenerator).
  Please help out on the forum by responding to questions and joining the debate.
* Create [GitHub tickets](https://github.com/sculptor/sculptor/issues) for bugs or new features and comment on the ones that you are interested in.
* GitHub is for social coding: if you want to write code, we encourage contributions [through pull requests](https://help.github.com/articles/creating-a-pull-request)
  from [forks of this repository](https://help.github.com/articles/fork-a-repo).
  If you want to contribute code this way, please reference a GitHub ticket as well covering the specific issue you are addressing.
  See [Sculptors documentation](http://sculptor.github.io/documentation/development-environment) for details on how to set up the development
  environment and build the project.
* If you want to help us with [documentation and tutorials](http://sculptor.github.io/documentation/), we encourage contributions
  [through pull requests](https://help.github.com/articles/creating-a-pull-request) from forks of the corresponding repository
  [https://github.com/sculptor/sculptor.github.io](https://github.com/sculptor/sculptor.github.io).
  See the repositories README for details on how to set up the development environment.


## License

Sculptor is released under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).