AmmyUI

KO | EN

gitlite — search

#javascript #react #typescript #llm #golang #android #machine-learning #rust #deep-learning #docker #nodejs #cli #mcp #open-source

(★ 380)

Ammy language repository

File Explorer

Download Latest Version (.zip)

- NuGet.Config
- NuGet.exe
- NuGet.targets
- packages.config
- 1.2.95.version
- ammy-host.nuspec
- ammy-uwp.nuspec
- ammy-wpf.nuspec
- ammy-xamarinforms.nuspec
- ammy.nuspec
- build-nugets.ps1
- init-local-packages.ps1
- upload-nugets-myget.ps1
- upload-nugets.ps1
- overview.md
- syntax.md
- - adb.exe
  - AdbWinApi.dll
  - AdbWinUsbApi.dll
- - DevExpress.Xpf.Grid.v16.2.Core.dll
  - DevExpress.Xpf.Grid.v16.2.dll
  - DevExpress.Xpf.Grid.v16.2.Extensions.dll
- - .gitignore
  - CSharp.Grammar.dll
  - DotNet.BackEnd.CCI.dll
  - DotNetLang.dll
  - Microsoft.Cci.MetadataHelper.dll
  - Microsoft.Cci.MetadataModel.dll
  - Microsoft.Cci.PeReader.dll
  - Nemerle.dll
  - Nemerle.Peg.dll
  - Nitra.Compiler.dll
  - Nitra.Grammar.dll
  - Nitra.Runtime.dll
  - Nitra.snk
  - System.Collections.Immutable.dll
- Microsoft.Cci.MetadataHelper.dll
- Microsoft.Cci.MetadataModel.dll
- Microsoft.Cci.PeReader.dll
- - lib-uwp.ammy
  - lib-wpf.ammy
  - lib-xamarin.ammy
- internal.cs
- - Ammy.Test.Common.csproj
  - Helpers.cs
  - SearchPageType.cs
- - Ammy.Test.Host.csproj
  - App.config
  - packages.config
  - Program.cs
  - test.ammy
- - Ammy.Test.Uwp.csproj
  - Ammy.Test.Uwp_TemporaryKey.pfx
  - Ammy.UwpTest_TemporaryKey.pfx
  - App.xaml
  - App.xaml.cs
  - ApplicationInsights.config
  - MainPage.xaml
  - MainPage.xaml.cs
  - MyUserControl.ammy
  - MyUserControl.ammy.cs
  - Package.appxmanifest
  - project.json
  - sqc-build.cmd
- - Ammy.Test.Workbench.csproj
  - App.ammy
  - App.ammy.cs
  - App.config
  - Code.cs
  - FodyWeavers.xml
  - lib-wpf.ammy_
  - MainWindow.ammy
  - MainWindow.ammy.cs
  - packages.config
  - ResourceDictionary.ammy
- - Ammy.Test.Wpf.csproj
  - App.ammy
  - App.ammy.cs
  - App.config
  - build-run.cmd
  - Extensions.cs
  - Helper.cs
  - packages.config
  - ResourceDictionary.ammy
  - test.cs
  - Utils.cs
  - Workbench.ammy
  - Workbench.ammy.cs
  - Workbench2.ammy
  - Workbench2.ammy.cs
- - Ammy.Test.XamarinForms.csproj
  - lib.ammy
  - MainPage.ammy
  - MainPage.ammy.cs
  - packages.config
- - config.xml
- - config.xml
- - AmmySidekick.dll
  - AmmyTest.Common.dll
- test.nsln
- visualizer-project-workbench.nsln
- visualizer-project.nsln
- - nuget.exe
- - run-msbuild.bat
  - vswhere.exe
- - App.ammy
  - App.ammy.cs
  - App.config
  - FileConverter.cs
  - FodyWeavers.xml
  - lib.ammy
  - MainWindow.ammy
  - MainWindow.ammy.cs
  - MainWindowMixins.ammy
  - packages.config
  - ProjectConverter.cs
  - XamlToAmmy.csproj
  - XamlToAmmy.sln
- .gitkeep
.gitignore
.gitmodules
Ammy.Samples.sln
Ammy.sln
Ammy.Tests.sln
build-all.cmd
build-ammy.cmd
build-nuget-host.cmd
build-nuget.cmd
LICENCE
README.md
release-notes.md
run-tests.cmd
run-unittests.cmd
upload-myget.cmd
upload-nuget.cmd

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ammy - UI Language for XAML platforms

Ammy is a modern UI language that either replaces or compliments XAML in your projects.

[Project site](http://www.ammyui.com)

[Documentation](http://www.ammyui.com/documentation/)

[Gitter chat](https://gitter.im/AmmyUI/Ammy)

[Roadmap](https://github.com/AmmyUI/AmmyUI/issues/75)

### Main features of Ammy

* Very simple JSON-like syntax
* Mixins and aliases to fight copy-pasting and to keep code [DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself)
* Inline Binding Converters to avoid implementing `IValueConverter`s for every simple task
* Runtime Update that actually works (VS2017 has very limited update functionality at the moment)

### How Ammy code looks

```
Window "MyApp.MainWindow" {
  Title: "My first Application"

Grid {
    TextBlock { "Hello, World!" }
  }
}
```

Note that you don't need to import any namespaces manually. In case you need to import external namespace, there is C# a `using` keyword available.

### Slightly more complicated example

```
alias FormField (labelText, binding)
{
  StackPanel {
    Orientation: Horizontal
    
    TextBlock { Text: $labelText }
    TextBlock {
      Text: $binding
    }
  }
}

Window "MyApp.MainWindow" {
  Title: "My First App"
  
  StackPanel { 
    @FormField ("First name", bind FirstName)
    @FormField ("Last name", bind LastName)
    
    TextBlock {
      Text: bind 
            convert (MyViewModel vm) => "Hello, " + vm.FirstName + " " + vm.LastName
    }
  }
}
```

## Building and debugging

* Install Visual Studio 2017 if you don't have one
* Install [Nemerle](http://nemerle.org) (Click "Download Now" button)
* Clone repository
* Open `Ammy.sln` solution in VS2017 and build it
* Set `Ammy.VisualStudio` project as StartUp Project and start Debugging session
* Open `Ammy.Tests.sln` solution 
* `Ammy.Test.Workbench` project is for debugging
* `Ammy.Test.Wpf` contains permanent tests that should all compile

## Project structure

### Syntax and AST

Ammy uses [Nitra](https://github.com/rsdn/nitra) for parsing and typing. First, file is parsed with syntax defined in Syntax.nitra. Resulting `ParseTree` is then mapped to AST (Mapping.nitra, MappingExpr.nitra, MappingFunctions.nitra).

Semantic analysis is a process where types loaded from Backend are binded to AST. This process defined inside Ast and AstBase projects in `.nitra` files.

* Ammy.Backend (Loads referenced assemblies and creates Nitra symbols)
* Ammy.AstBase (Common AST types)
* Ammy.Ast (More AST types)
* Ammy.Syntax (Syntax and Mapping to AST)

### Sidekick

Sidekick library has two primary functions. 1) `ExpressionConverter` used for inline binding converters 2) Runtime update logic

* Ammy.Sidekick.XamarinForms
* Ammy.Sidekick.Uwp
* Ammy.Sidekick.Common

### Compilation and Tasks

Build assembly is a glue between IDE/MSBuild and Ammy language.

* Ammy.Build
* Ammy.BamlCompilerWPF

### IDE

* Ammy.VisualStudio
* Ammy.VisualStudio.Service
* Ammy.VisualStudio.ItemTemplates

Ammy.VisualStudio only contains service providers. These providers use RuntimeLoader to load Ammy.VisualStudio.Service assembly and load actual services. Ammy.VisualStudio.Service contains all the logic for highlighting, intelli-sense, regions, adornments, classisifiers and other stuff.

AmmyUI

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

AmmyUI

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README