StoryQ

New Post: Generate documentation automatically?

cocowalla — Thu, 06 Jun 2013 13:23:49 GMT

Is there any way to generate user story documentation automatically based on test methods?

I'm thinking something along the lines of Pickles for SpecFlow.

New Post: Modifying or configuring output

gregsdennis — Tue, 05 Mar 2013 16:33:26 GMT

Please see the original post on StackOverflow.

The API provides an OverrideMethodFormatAttribute (subclassed from the abstract class MethodFormatAttribute), which works if you want to use a specific string constant, but C# doesn't like the method's type parameters in attributes. This doesn't compile due to the T in the attribute:

[OverrideMethodFormat(string.Format("exception is thrown ({0})", typeof(T).Name))]
private void ExceptionIsThrown<T>() where T : Exception
{
    ...
}

The solution is to create another MethodFormatAttribute subclass that specifically searches the method for generic types and output them. This subclass is below:

public class GenericMethodFormatAttribute : MethodFormatAttribute
{
    private readonly string _textFormat;

    public GenericMethodFormatAttribute(string textFormat = null)
    {
        _textFormat = textFormat;
    }

    public override string Format(MethodInfo method, IEnumerable<string> parameters)
    {
        var generics = method.GetGenericArguments();
        if (_textFormat == null)
        {
            var genericsList = string.Join<Type>(", ", generics);
            return string.Format("{0} ({1})", UnCamel(method.Name), genericsList);
        }
        return string.Format(_textFormat, generics);
    }
}

Usage is almost like the supplied attribute, except that you optionally supply a format string instead of a string constant. Omitting the format string un-camel-cases the method name just like the default behavior.

[GenericMethodFormatAttribute]
private void ExceptionIsThrown<T>() where T : Exception
{
    ...
}

This allows me to declare the attribute in my source, while not having to touch the StoryQ code. Ten points to StoryQ for extensibility!

New Post: Modifying or configuring output

gregsdennis — Tue, 05 Mar 2013 14:19:45 GMT

Is there a way to modify or configure the output (both output window and file) to include custom strings? For example, one of my stories requires that a specific exception is thrown. To do this, I catch the exception and save it, then in a separate method test that it's non-null and of the required type. I'd like to be able to append the type of the exception to the output (much like parameters are appended to method calls).

For example

    .Then(ExceptionIsThrown<ArgumentNullException>)

would result in the following output

   then exception is thrown (ArgumentNullException)

Thanks.

Commented Issue: Cannot translate to Russian [16121]

ni28 — Mon, 25 Feb 2013 08:49:01 GMT

Hello!

I have created a Russian grammar file (attached). However the generate.ps1 script shows the following error when processing this file:

ru-RU.txt
- Generating obj\StoryQ.flit.ru-RU code from ru-RU
error : Running transformation: System.NullReferenceException: Object reference not set to an instance of an object.
in Microsoft.VisualStudio.TextTemplating673cb8208b3b4c71b29c04fb73c92521.GeneratedTextTransformation.TransformText() in
c:\Users\Никита\AppData\Local\Temp\obj\StoryQ.flit.tt:line 219
in Microsoft.VisualStudio.TextTemplating.TransformationRunner.RunTransformation(TemplateProcessingSession session, Str
ing source, ITextTemplatingEngineHost host, String& result)

It seems that the TextTransform.exe does not like Cyrillics. I also doubt that translation to other languages that are not based on English alphabet is possible.

I've managed to create the StoryQ.flit.ru-RU.g.cs that works for me manually (using the StoryQ.flit.en-US.g.cs file as a source).
Comments: Here is the manually created StoryQ.flit.ru-RU.g.cs.

Created Issue: Cannot translate to Russian [16121]

ni28 — Mon, 25 Feb 2013 08:48:17 GMT

New Post: Throwing Exception on the first fail

Johanan — Tue, 05 Feb 2013 12:31:21 GMT

Hello!
Is there any way to make StoryQ throw an exception after the first step failure? Any options or configurations maybe?

New Comment on "write your first StoryQ test"

yuipcheng — Mon, 07 Jan 2013 17:09:07 GMT

When I use the UI tool "StoryQ.Converter.Wpf.exe", my stories seem to be saved somewhere because if I reopen the UI tool, my stories appears and the original template is gone. So my question is that where is my stories saved to?

New Post: I need to post Stories from StoryQ into Jira

RobAnton — Sun, 06 Jan 2013 22:50:08 GMT

I just downloaded the latest copy of StoryQ Converter but am having trouble finding how to export stories into Jira. I think I have the wrong version.

In the past, I as able to move the scroll bar to display a format which was the JIRA offshoot from JavaScript.

Something lik this.

h4. Changing stuff
{color:#707070}There are a few ways you can edit an issue, we'll let you know them all and then you can pick which ones you like best:{color}
* {color:#707070}Inline edit by clicking in the field you want to change. Try clicking here to edit this text.{color}
* {color:#707070}Keyboard shortcut: !e.png!{color}
* {color:#707070}Jump to field using keyboard shortcut: !comma.png!{color}
* {color:#707070}Click the Edit button in the operations bar{color}

{color:#707070}(!) *Note*: some items in the view issue page, like the status and resolution, are only changed by workflow buttons.{color}

h4. Commenting
{color:#707070}Adding comments is a great way to communicate with multiple people on an issue. As an example you'll see there's a question in the comment section at the bottom of this issue, try replying to the comment!
{color}

!Comment.png!

How do I do this?

Then, if still possible, once I have it on the clipboard, where in Jira do I paste it. I forget.

Thanks.

New Post: The future of StoryQ

yuipcheng — Fri, 04 Jan 2013 20:22:17 GMT

i had the same question, thank you for making it clear toddb.

New Post: The future of StoryQ

toddb — Fri, 21 Dec 2012 20:47:30 GMT

johan,

StoryQ is maintained and this list generally responded to. However, we have seen no need to make changes given the niche area StoryQ is for and have no outstanding bugs.

I hope that helps.

Todd

New Post: The future of StoryQ

johanmartensson — Fri, 21 Dec 2012 10:55:55 GMT

I'm just getting into the world of testing and I'm looking at different possibilities. StoryQ looks really interesting but I'm worried that the latest stable release is from July 2010.

Is StoryQ still being developed? If not it might not be the best idea for me to start building my test with it.

New Post: How do I convert - noob with a potentially dumb question

jallendelaney — Wed, 21 Nov 2012 18:42:38 GMT

I have a very simple test of a validator class that I can easily unit test using the Microsoft framework. However, due to the reporting and readability we want to use StoryQ for our test. Unfortunately, I cannot convert this test:

public void SsnValidator_Constructor_Test()
        {
            Assert.AreEqual(Mother.ValidSsn, this._happyTarget._value, "Private member variable '_value' does not match the constructor variable.");
        }

Here is the corresponding class:

 class SsnValidator:IValidator
    {private string _value ="";

    public SsnValidator(string value)
        {
            this._value = value;
        }

        public bool IsValid()
        {
            return (
                (this._value != "") && 
                (this._value.Length==11) && 
                (HasNoLetters(this._value)) &&
                (Has2Dashes(this._value))
                );
        }

        private static bool HasNoLetters(string value)
        {
            long result;
            return long.TryParse(value.Replace("-", ""), out result);
        }

        private static bool Has2Dashes(string value)
        {
            int dashCount = 0;
            var ssnChars = value.ToCharArray();

            dashCount = ssnChars.Count(c => c == '-');


            return (dashCount == 2);
        }
    }

I realize this is a very, very simple test, but we are bringing a whole team into the TDD model and we need to keep it as simple as possible until everyone is comfortable. Still, can someone give the StoryQ equivalent of this test? I am not sure how to populate the .Give, .When, .Then is this scenario.

Thanks in advance.

New Comment on "write your first StoryQ test"

davidkallen — Wed, 14 Nov 2012 03:18:34 GMT

Wow! Nice API. Very simple to use, and produces valuable documentation. I love the fluent interface.

New Post: StoryQ Code Coverage

Brother_Raziel — Thu, 23 Aug 2012 14:09:23 GMT

SOLVED.

Only NCover v4 can do this, becasue you can select which dll files should be tested ;)

New Post: StoryQ Code Coverage

Brother_Raziel — Thu, 23 Aug 2012 08:51:57 GMT

Is it posible to get correct code coverage report, because i get code coverage of storyQ function/namespaces/classes ( like Condition+<>c__DisplayClass1`1) instead of my project function/namespaces/classes.

i'm using NUnit as a storyQ test runner nad NCover to get code coverage.

Thanks in advance for answer

New Post: A few questions on StoryQ Converter

jpitz31 — Fri, 17 Aug 2012 20:01:27 GMT

In other BDD scenario creation tools, you have the ability to create more than one story (given, when and then) in the feature screen (specFlow)

Can you create more tthan one story in the StoryQ Converter Story Window. When I attempt this I get a syntax error.

When creating a story I would like to save this and check this in with the Visual Studio project in TFS.

It appears that StoryQ Converter remembers the last story that was typed in. Is there a way to save this story out to a file?

Thanks

Joe

New Post: problem with .ExecuteWithReport(MethodBase.GetCurrentMethod());

jpitz31 — Thu, 02 Aug 2012 21:09:55 GMT

Hello Guys,

Thanks for the feedback.

I found the problem. If I compile everything with 64 bit, Visual Studio test project, StoryQ.Dll project and my Selenium Project The ExecuteWithReport() fails with the above errors. I also cannot debug step into the StoryQDll project, even when I add the project to my test solution.

If I recompile everything back to 32 bit the test project runs just fine, generating the .xml results files and I can debug the StoryQ.dll project from my test project.

Thanks

Joe

New Post: problem with .ExecuteWithReport(MethodBase.GetCurrentMethod());

toddb — Thu, 02 Aug 2012 19:24:17 GMT

I don't know this one, however, I have had problems with MSTest on 64 bit but you have tried NUnit ruling out that problem. Go Rob!

New Post: problem with .ExecuteWithReport(MethodBase.GetCurrentMethod());

robfe — Thu, 02 Aug 2012 19:07:43 GMT

I might know this one: Does your test class have a namespace?

New Post: problem with .ExecuteWithReport(MethodBase.GetCurrentMethod());

jpitz31 — Thu, 02 Aug 2012 17:23:31 GMT

I have encountered a problem with ExecuteWithReport()

I have a 64 bit test, I have tried both MS Test and NUnit running 64 bit application.

Test runs selenium and performs a simple login to a web site.

When I run the test using .Execute() the test performs successfully.

When I attempt to run with ExecuteWithReport() I get the following error:

Test method StoryQTestClass.UserLogin threw exception: System.ArgumentNullException: Value cannot be null.Parameter name: value

System.Xml.Linq.XAttribute.ctor(XName name,Object value)StoryQ.Execution.Rending.XmlCategoriser.GetOrCreateElementForMethodInfo(MethodBase categoriser)StoryQ.Execution.Rending.XmlCategoriser.GetRenderer(MethodBase categoriser)StoryQ.Infrastructure.FrameBase.ExecuteWithReport(MethodBase currentMethod)

Before I tear into debugging the StoryQ.dll I was wondering if anyone has encountered this ans has a fix or work around.

Thanks

Joe