air_test 0.1.5.4 → 0.1.5.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec50dc985e53dbbb63a785aee66594b94387384039f7db14677004ee2fce3178
-  data.tar.gz: bf0a4675e548c04c695059e949674c9b6ca2d67ce1135471a56ff09072fe1aa5
+  metadata.gz: 8174f558c0b41c33acc6d4a468ad38c36e621c188a6ea022b7dc2ae500fcee3c
+  data.tar.gz: d84cc877b0841689de2f62e7055b68955fcf7352bbda10f65cc60969f959a1ac
 SHA512:
-  metadata.gz: f9321031cb35c3c6bac0f6400edb9efb8f8305247c64a9a6cf3136931dcbcd908ccf3b80feca89bb550744359f679addd6b0f84c2fd03794f3dba7dc78544bc4
-  data.tar.gz: 2521991e2cbe8dd447a4192436c1b2123d2e5313fbf04ce7a81f27a81a12e26f719f3ce8dfb880a39334d658cd105cfe73d0f91c74f6cf2a71ce285ae6b55f25
+  metadata.gz: f2089f266b3606af5c05f5153305a56e1e695391642c3b5775c81ba55b8d4752748628d74ec6e30f3a3b0df0d02cd2aca856fcf8b8d4350eaaa0fc3833b9cb44
+  data.tar.gz: c41e1ca2dfeb4e694126276a262dded5e62e1e0252024ecca5a6a9cbcb46a39d61e80754a0488cfee83b4e844604bba1362ad790e1f009b83df30f48b7e75b1f

data/README.md

@@ -49,6 +49,47 @@ Make sure your environment variables are set (in `.env`, your shell, or your CI/
 
 ---
 
+## 📝 Creating Notion Tickets with Gherkin Format
+
+To ensure that your Notion tickets are compatible with the air_test automation, follow these guidelines when creating your tickets:
+
+### 1. Create a New Page in Notion
+
+- Start by creating a new page in your Notion workspace for each ticket.
+
+### 2. Use the Gherkin Syntax
+
+- Each ticket should follow the Gherkin syntax, which includes the following keywords:
+  - **Feature**: A high-level description of the feature being implemented.
+  - **Scenario**: A specific situation or case that describes how the feature should behave.
+  - **Given**: The initial context or state before the scenario starts.
+  - **When**: The action that triggers the scenario.
+  - **Then**: The expected outcome or result of the action.
+
+### 3. Example Structure
+
+Here’s an example of how to structure a ticket in Notion:
+
+Feature: User Login
+Scenario: Successful login with valid credentials
+Given the user is on the login page
+When the user enters valid credentials
+Then the user should be redirected to the dashboard
+Scenario: Unsuccessful login with invalid credentials
+Given the user is on the login page
+When the user enters invalid credentials
+Then an error message should be displayed
+
+### 4. Additional Tips
+
+- Ensure that each ticket is clearly titled and contains all necessary scenarios.
+- Use bullet points or toggle lists in Notion to organize multiple scenarios under a single feature.
+- Make sure to keep the Gherkin syntax consistent across all tickets for better parsing.
+
+By following these guidelines, you can create Notion tickets that are ready to be parsed by the air_test automation tool.
+
+---
+
 ## 🛠 Usage
 
 Run the automated workflow from your Rails project terminal:
@@ -74,17 +115,6 @@ bundle exec rake air_test:generate_specs_from_notion
 
 ---
 
-## 🧩 Gem Structure
-
-- `lib/air_test/configuration.rb`: centralized configuration
-- `lib/air_test/notion_parser.rb`: Notion extraction and parsing
-- `lib/air_test/spec_generator.rb`: spec and step file generation
-- `lib/air_test/github_client.rb`: git and GitHub PR management
-- `lib/air_test/runner.rb`: workflow orchestrator
-- `lib/tasks/air_test.rake`: Rake task to launch the automation
-
----
-
 ## 📝 Example .env
 
 ```
@@ -103,17 +133,6 @@ GITHUB_BOT_TOKEN=ghp_xxx
 
 ---
 
-## 📦 Publishing the Gem (optional)
-
-To publish the gem on RubyGems:
-
-```sh
-gem build air_test.gemspec
-gem push air_test-x.y.z.gem
-```
-
----
-
 ## 👨‍💻 Author & License
 
 - Author: [Airtest]

data/lib/air_test/notion_parser.rb

@@ -26,9 +26,16 @@ module AirTest
 
     def parse_ticket_content(page_id)
       blocks = get_page_content(page_id)
+      # puts "\n===== RAW NOTION BLOCKS ====="
+      # puts JSON.pretty_generate(blocks)
       return nil unless blocks
-
-      parse_content(blocks)
+      normalized_blocks = normalize_blocks(blocks)
+      # puts "\n===== NORMALIZED BLOCKS ====="
+      # puts JSON.pretty_generate(normalized_blocks)
+      parsed_data = parse_content(normalized_blocks)
+      # puts "\n===== PARSED DATA ====="
+      # puts JSON.pretty_generate(parsed_data)
+      parsed_data
     end
 
     def extract_ticket_title(ticket)
@@ -220,6 +227,31 @@ module AirTest
         ""
       end
     end
+
+    # Normalize Notion blocks: split multi-line blocks into one-line synthetic paragraph blocks
+    def normalize_blocks(blocks)
+      normalized = []
+      blocks.each do |block|
+        block_type = block["type"]
+        text = if block[block_type] && block[block_type]["rich_text"]
+          block[block_type]["rich_text"].map { |rt| rt["plain_text"] }.join("")
+        else
+          ""
+        end
+        lines = text.split("\n").map(&:strip).reject(&:empty?)
+        if lines.size > 1
+          lines.each do |line|
+            normalized << {
+              "type" => "paragraph",
+              "paragraph" => { "rich_text" => [{ "plain_text" => line }] }
+            }
+          end
+        else
+          normalized << block
+        end
+      end
+      normalized
+    end
   end
 end
 

data/lib/air_test/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AirTest
-  VERSION = "0.1.5.4"
+  VERSION = "0.1.5.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: air_test
 version: !ruby/object:Gem::Version
-  version: 0.1.5.4
+  version: 0.1.5.7
 platform: ruby
 authors:
 - julien bouland