Project: gauge-java (GitHub Link)

gauge-java-master
- genproto.sh
- .github
  - issue_template.md
  - workflows
    - release_on_pr.yml
    - tests.yml
- src
  - main
    - java
      - gauge
        messages
        Services.java
        RunnerGrpc.java
      - com
        thoughtworks
        gauge
        AfterClassSteps.java
        AfterSuite.java
        BeforeSpec.java
        Step.java
        Gauge.java
        AfterScenario.java
        StepValue.java
        StepDetails.java
        BeforeSuite.java
        GaugeRuntime.java
        processor
        SpecExecutionEndingProcessor.java
        StepNamesRequestProcessor.java
        StepExecutionStartingProcessor.java
        IMessageProcessor.java
        ScenarioExecutionStartingProcessor.java
        SuiteExecutionEndingProcessor.java
        StepNameRequestProcessor.java
        ScenarioExecutionEndingProcessor.java
        DefaultMessageProcessor.java
        ExecuteStepProcessor.java
        StepExecutionEndingProcessor.java
        CacheFileRequestProcessor.java
        SpecExecutionStartingProcessor.java
        ValidateStepProcessor.java
        ClearObjectCache.java
        KillProcessProcessor.java
        SuiteExecutionStartingProcessor.java
        StepPositionsRequestProcessor.java
        MethodExecutionMessageProcessor.java
        RefactorRequestProcessor.java
        hook
        Hook.java
        BeforeScenario.java
        ClasspathHelper.java
        registry
        HooksRegistry.java
        ClassInitializerRegistry.java
        StepRegistry.java
        TableRow.java
        TableCell.java
        tag
        AndMatcher.java
        TagMatcher.java
        SimpleTagMatcher.java
        OrMatcher.java
        Scenario.java
        Specification.java
        screenshot
        ScreenshotFactory.java
        CustomScreenshotScanner.java
        CustomScreenshot.java
        ICustomScreenshotGrabber.java
        CustomScreenshotWriter.java
        DefaultClassInitializer.java
        datastore
        DataStoreInitializer.java
        DataStoreFactory.java
        DataStore.java
        connection
        StubImplementationCodeProcessor.java
        MessageProcessorFactory.java
        StepRegistryEntry.java
        RowSizeMismatchException.java
        AfterSpec.java
        AfterStep.java
        Util.java
        ClassInitializer.java
        ContinueOnFailure.java
        Operator.java
        execution
        ExecutionInfoMapper.java
        HookExecutionStage.java
        ExecutionStage.java
        parameters
        parsers
        base
        ParameterParsingChain.java
        ParameterParser.java
        CustomParameterParser.java
        converters
        TableConverter.java
        StringToPrimitiveConverter.java
        types
        PrimitivesConverter.java
        PrimitiveParameterParser.java
        TableParameterParser.java
        EnumParameterParser.java
        ParametersExtractor.java
        DynamicParametersReplacer.java
        ParsingException.java
        HooksExecutor.java
        MethodExecutor.java
        ExecutorPool.java
        StepExecutionStage.java
        ExecutionPipeline.java
        AbstractExecutionStage.java
        ExecutionContext.java
        scan
        IScanner.java
        HooksScanner.java
        StepsUtil.java
        StaticScanner.java
        ClasspathScanner.java
        RegistryMethodVisitor.java
        StepsScanner.java
        CustomClassInitializerScanner.java
        BeforeStep.java
        Logger.java
        Table.java
        refactor
        JavaRefactoringElement.java
        JavaParseWorker.java
        RefactoringException.java
        RefactoringMethodVisitor.java
        FileModifier.java
        RefactoringResult.java
        Diff.java
        JavaRefactoring.java
        BeforeClassSteps.java
        GaugeConstant.java
        command
        SetupCommand.java
        GaugeJavaCommand.java
        StartCommand.java
        GaugeCommandFactory.java
        ScreenshotCollector.java
        MessageCollector.java
        FileHelper.java
        ClassInstanceManager.java
        RunnerServiceHandler.java
  - test
    - resources
      - test
        files
        unformatted
        UnFormattedStepImpl.java
        Empty.java
        fooAliases.java
        foo.java
        formatted
        StepImpl.java
        StepImplWithComments.java
    - java
      - com
        thoughtworks
        gauge
        UtilTest.java
        ScreenshotCollectorTest.java
        processor
        StepPositionsRequestProcessorTest.java
        ValidateStepProcessorTest.java
        StubImplementationCodeProcessorTest.java
        CacheFileRequestProcessorTest.java
        DefaultMessageProcessorTest.java
        StepNameRequestProcessorTest.java
        TestStepImplClass.java
        hook
        HookTest.java
        registry
        HooksRegistryTest.java
        StepRegistryTest.java
        tag
        AndMatcherTest.java
        OrMatcherTest.java
        test
        TestHelpers.java
        AnEnum.java
        TestValues.java
        Matchers.java
        FileHelperTest.java
        execution
        HooksExecutorTest.java
        ParameterTestHelpers.java
        parameters
        parsers
        types
        TableParameterParserTest.java
        PrimitiveParameterParserTest.java
        EnumParameterParserTest.java
        DynamicParametersReplacerTest.java
        ParametersExtractorTest.java
        ExecutionPipelineTest.java
        ExecutionInfoMapperTest.java
        AbstractExecutionStageTest.java
        StepExecutionStageTest.java
        TableTest.java
        scan
        StaticScannerTest.java
        StepsScannerTest.java
        TableRowTest.java
        refactor
        JavaRefactoringTest.java
        ClassInstanceManagerTest.java
        MessageCollectorTest.java
        ExecutionContextTest.java
  - META-INF
    - MANIFEST.MF
- build.ps1
- checkstyle.xml
- pom.xml
- .gitmodules
- CONTRIBUTING.md
- notice.md
- java.json
- gauge-proto
- README.md
- CODE_OF_CONDUCT.md
- bin
  - launcher.sh
  - launcher.cmd
  - launcher.ps1
- .gitignore
- LICENSE.txt
- build.sh

Gauge-Java

This project adds java language plugin for gauge.

Getting started

Pre-requisite

Installation

gauge install java

Create a gauge-java project

gauge init java

Run tests

gauge run specs

Alternate Installation options

Install specific version

Installing specific version
```
gauge install java --version 0.6.5
```

Offline installation

Download the plugin from Releases

gauge install java --file gauge-java-0.6.5-windows.x86_64.zip

Build from source

The plugin is authored in Java. Gauge is authored in golang. These are independent processes talking to each other over TCP on port GAUGE_INTERNAL_PORT (env variable) using Protobuf.

Additional Requirements

Apart from Gauge and Java you will need

Maven
JQ (for unix)
Compiling

./build.sh | .\build.ps1 build

Installing

After compilation

./build.sh | .\build.ps1 forceinstall

Creating distributable

Note: Run after compiling

./build.sh | .\build.ps1 package

Deployment

The deployments are managed via Github Actions. Whenever a PR is merged and contains label ReleaseCandidate, A deployment will occur with the current version and then the version will be bumped up.

License

This program is licensed under:

Apache License, Version 2.0

Copyright

Copyright 2016 ThoughtWorks, Inc.

Acknowledgements

This project is supported by YourKit Java Profiler. YourKit supports open source projects with its full-featured Java Profiler, which is used by Gauge Team.

Yourkit