web2cli 0.2.0__py3-none-any.whl

web2cli/adapters/slack.com/web2cli.yaml

@@ -0,0 +1,445 @@
+meta:
+  spec_version: "0.2"
+  name: slack
+  domain: slack.com
+  base_url: https://slack.com/api
+  version: 0.2.0
+  description: "Slack — channels, messages, DMs"
+  author: web2cli-core
+  transport: http
+  impersonate: chrome
+  aliases:
+    - slack
+  default_headers:
+    User-Agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
+    Accept: "application/json"
+
+auth:
+  methods:
+    - type: cookies
+      keys: [d]
+      env_var: WEB2CLI_SLACK_COOKIES
+    - type: token
+      env_var: WEB2CLI_SLACK_TOKEN
+      inject:
+        target: form
+        key: token
+      capture:
+        from: request.form
+        key: token
+        match:
+          host: slack.com
+          path_regex: "^/api/"
+          method: POST
+
+resources:
+  users:
+    cache:
+      key: users
+      ttl: 600
+    request:
+      method: POST
+      url: /users.list
+      body:
+        encoding: form
+        template:
+          limit: 200
+    paginate:
+      cursor_param: cursor
+      cursor_location: body
+      cursor_path: "$.response_metadata.next_cursor"
+    response:
+      format: json
+      extract: "$.members[*]"
+      fields:
+        - name: id
+          from: "$.id"
+        - name: name
+          from:
+            coalesce:
+              - "$.profile.display_name"
+              - "$.profile.real_name"
+              - "$.real_name"
+              - "$.name"
+
+  channels:
+    cache:
+      key: channels
+      ttl: 300
+    request:
+      method: POST
+      url: /conversations.list
+      body:
+        encoding: form
+        template:
+          types: public_channel,private_channel
+          limit: 200
+    paginate:
+      cursor_param: cursor
+      cursor_location: body
+      cursor_path: "$.response_metadata.next_cursor"
+    response:
+      format: json
+      extract: "$.channels[*]"
+      fields:
+        - name: id
+          from: "$.id"
+        - name: name
+          from: "$.name"
+        - name: topic
+          from: "$.topic.value"
+        - name: purpose
+          from: "$.purpose.value"
+        - name: num_members
+          from: "$.num_members"
+        - name: is_private
+          from: "$.is_private"
+
+  dm_channels:
+    cache:
+      key: dm_channels
+      ttl: 300
+    request:
+      method: POST
+      url: /conversations.list
+      body:
+        encoding: form
+        template:
+          types: im
+          limit: 200
+    paginate:
+      cursor_param: cursor
+      cursor_location: body
+      cursor_path: "$.response_metadata.next_cursor"
+    response:
+      format: json
+      extract: "$.channels[*]"
+      fields:
+        - name: id
+          from: "$.id"
+        - name: user_id
+          from: "$.user"
+        - name: user_name
+          from: "$.user"
+          ops:
+            - map_lookup:
+                from: "steps.users.map_by_id"
+                default: unknown
+
+commands:
+  me:
+    description: "Show current user and workspace info"
+    pipeline:
+      - request:
+          name: fetch
+          method: POST
+          url: /auth.test
+          body:
+            encoding: form
+            template: {}
+      - parse:
+          name: parsed
+          from: fetch
+          format: json
+          extract: "$"
+          fields:
+            - name: ok
+              from: "$.ok"
+            - name: user_id
+              from: "$.user_id"
+            - name: user
+              from: "$.user"
+            - name: team_id
+              from: "$.team_id"
+            - name: team
+              from: "$.team"
+            - name: url
+              from: "$.url"
+            - name: error
+              from: "$.error"
+    output:
+      from_step: parsed
+      default_fields: [user, team, url]
+      default_format: table
+
+  channels:
+    description: "List channels in workspace"
+    pipeline:
+      - resolve:
+          name: channels
+          resource: channels
+          input: null
+          by: name
+          value: id
+    output:
+      from_step: channels
+      default_fields: [name, topic, num_members]
+      default_format: table
+
+  messages:
+    description: "Get messages from a channel"
+    args:
+      channel:
+        type: string
+        required: true
+        description: "Channel name"
+      limit:
+        type: int
+        required: false
+        default: 20
+        max: 200
+        description: "Number of messages to fetch"
+    pipeline:
+      - resolve:
+          name: users
+          resource: users
+          input: null
+          by: id
+          value: name
+      - resolve:
+          name: channel
+          resource: channels
+          input: "{{args.channel}}"
+          by: name
+          value: id
+          match: ci_equals
+      - request:
+          name: fetch
+          method: POST
+          url: /conversations.history
+          body:
+            encoding: form
+            template:
+              channel: "{{steps.channel.id}}"
+              limit: "{{args.limit}}"
+      - parse:
+          name: parsed
+          from: fetch
+          format: json
+          extract: "$.messages[*]"
+          fields:
+            - name: author
+              from: "$.user"
+              ops:
+                - map_lookup:
+                    from: "steps.users.map_by_id"
+                    default: unknown
+            - name: content
+              from: "$.text"
+            - name: timestamp
+              from: "$.ts"
+              transform: timestamp
+            - name: reactions
+              from: "$.reactions[*].name"
+              ops:
+                - join:
+                    sep: " "
+            - name: type
+              from: "$.subtype"
+              default: message
+            - name: ts
+              from: "$.ts"
+          post_ops:
+            - reverse
+    output:
+      from_step: parsed
+      default_fields: [author, content, timestamp, reactions]
+      default_format: table
+
+  send:
+    description: "Send a message to a channel"
+    args:
+      channel:
+        type: string
+        required: true
+        description: "Channel name"
+      message:
+        type: string
+        required: true
+        source: [arg, stdin]
+        description: "Message content"
+    pipeline:
+      - resolve:
+          name: channel
+          resource: channels
+          input: "{{args.channel}}"
+          by: name
+          value: id
+          match: ci_equals
+      - request:
+          name: send
+          method: POST
+          url: /chat.postMessage
+          body:
+            encoding: form
+            template:
+              channel: "{{steps.channel.id}}"
+              text: "{{args.message}}"
+      - parse:
+          name: parsed
+          from: send
+          format: json
+          extract: "$"
+          fields:
+            - name: ok
+              from: "$.ok"
+            - name: channel
+              from: "$.channel"
+            - name: timestamp
+              from: "$.message.ts"
+              transform: timestamp
+            - name: content
+              from: "$.message.text"
+            - name: error
+              from: "$.error"
+    output:
+      from_step: parsed
+      default_fields: [ok, channel, timestamp]
+      default_format: table
+
+  dm:
+    description: "List DM conversations"
+    pipeline:
+      - resolve:
+          name: users
+          resource: users
+          input: null
+          by: id
+          value: name
+      - resolve:
+          name: dm_list
+          resource: dm_channels
+          input: null
+          by: user_name
+          value: id
+    output:
+      from_step: dm_list
+      default_fields: [user_name, user_id]
+      default_format: table
+
+  dm-messages:
+    description: "Get messages from a DM conversation"
+    args:
+      user:
+        type: string
+        required: true
+        description: "User display name"
+      limit:
+        type: int
+        required: false
+        default: 20
+        max: 200
+        description: "Number of messages to fetch"
+    pipeline:
+      - resolve:
+          name: users
+          resource: users
+          input: null
+          by: id
+          value: name
+      - resolve:
+          name: dm_channel
+          resource: dm_channels
+          input: "{{args.user}}"
+          by: user_name
+          value: id
+          match: ci_equals
+      - request:
+          name: fetch
+          method: POST
+          url: /conversations.history
+          body:
+            encoding: form
+            template:
+              channel: "{{steps.dm_channel.id}}"
+              limit: "{{args.limit}}"
+      - parse:
+          name: parsed
+          from: fetch
+          format: json
+          extract: "$.messages[*]"
+          fields:
+            - name: author
+              from: "$.user"
+              ops:
+                - map_lookup:
+                    from: "steps.users.map_by_id"
+                    default: unknown
+            - name: content
+              from: "$.text"
+            - name: timestamp
+              from: "$.ts"
+              transform: timestamp
+            - name: reactions
+              from: "$.reactions[*].name"
+              ops:
+                - join:
+                    sep: " "
+            - name: type
+              from: "$.subtype"
+              default: message
+            - name: ts
+              from: "$.ts"
+          post_ops:
+            - reverse
+    output:
+      from_step: parsed
+      default_fields: [author, content, timestamp, reactions]
+      default_format: table
+
+  dm-send:
+    description: "Send a DM to a user"
+    args:
+      user:
+        type: string
+        required: true
+        description: "User display name"
+      message:
+        type: string
+        required: true
+        source: [arg, stdin]
+        description: "Message content"
+    pipeline:
+      - resolve:
+          name: users
+          resource: users
+          input: null
+          by: id
+          value: name
+      - resolve:
+          name: dm_channel
+          resource: dm_channels
+          input: "{{args.user}}"
+          by: user_name
+          value: id
+          match: ci_equals
+      - request:
+          name: send
+          method: POST
+          url: /chat.postMessage
+          body:
+            encoding: form
+            template:
+              channel: "{{steps.dm_channel.id}}"
+              text: "{{args.message}}"
+      - parse:
+          name: parsed
+          from: send
+          format: json
+          extract: "$"
+          fields:
+            - name: ok
+              from: "$.ok"
+            - name: channel
+              from: "$.channel"
+            - name: timestamp
+              from: "$.message.ts"
+              transform: timestamp
+            - name: content
+              from: "$.message.text"
+            - name: error
+              from: "$.error"
+    output:
+      from_step: parsed
+      default_fields: [ok, channel, timestamp]
+      default_format: table

web2cli/adapters/stackoverflow.com/web2cli.yaml

@@ -0,0 +1,257 @@
+meta:
+  spec_version: "0.2"
+  name: stackoverflow
+  domain: stackoverflow.com
+  base_url: https://stackoverflow.com
+  version: 0.2.0
+  description: "Stack Overflow — search questions, read answers, browse tags"
+  author: web2cli-core
+  transport: http
+  impersonate: chrome
+  aliases:
+    - so
+  default_headers:
+    User-Agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
+    Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+    Accept-Language: "en-US,en;q=0.9"
+    Accept-Encoding: "gzip, deflate, br"
+
+auth:
+  methods:
+    - type: cookies
+      keys: [cf_clearance]
+      env_var: WEB2CLI_SO_COOKIES
+
+commands:
+  search:
+    description: "Search Stack Overflow questions"
+    args:
+      query:
+        type: string
+        required: true
+        source: [arg, stdin]
+        description: "Search query (same syntax as SO search bar)"
+      limit:
+        type: int
+        required: false
+        default: 15
+        max: 50
+        description: "Results per page"
+      sort:
+        type: string
+        required: false
+        default: relevance
+        enum: [relevance, newest, votes, active]
+        description: "Sort order"
+    pipeline:
+      - request:
+          name: fetch
+          method: GET
+          url: /search
+          params:
+            q: "{{args.query}}"
+            pagesize: "{{args.limit}}"
+            tab: "{{args.sort}}"
+      - parse:
+          name: parsed
+          from: fetch
+          format: html
+          extract: "div.s-post-summary"
+          fields:
+            - name: title
+              path: "h3 a.s-link"
+              attribute: text
+            - name: url
+              path: "h3 a.s-link"
+              attribute: href
+              prefix: "https://stackoverflow.com"
+            - name: votes
+              path: "span.s-post-summary--stats-item-number:nth-of-type(1)"
+              attribute: text
+              transform: int
+            - name: answers
+              path: "div.s-post-summary--stats-item:nth-of-type(2) span.s-post-summary--stats-item-number"
+              attribute: text
+              transform: int
+            - name: views
+              path: "div.s-post-summary--stats-item:nth-of-type(3) span.s-post-summary--stats-item-number"
+              attribute: text
+            - name: tags
+              path: "ul.ml0 li a.post-tag"
+              attribute: text
+              collect: true
+              join: ", "
+            - name: excerpt
+              path: "div.s-post-summary--content-excerpt"
+              attribute: text
+              truncate: 80
+      - transform:
+          name: sorted
+          from: parsed
+          ops:
+            - sort:
+                by: votes
+                order: desc
+    output:
+      from_step: sorted
+      default_fields: [title, votes, answers, tags]
+      default_format: table
+
+  question:
+    description: "Read a specific question and its top answers"
+    args:
+      id:
+        type: string
+        required: true
+        source: [arg, stdin]
+        description: "Question ID (number from URL)"
+    pipeline:
+      - request:
+          name: fetch
+          method: GET
+          url: /questions/{{args.id}}
+      - parse:
+          name: question
+          from: fetch
+          format: html
+          extract: "body"
+          fields:
+            - name: type
+              path: ".__web2cli_missing__"
+              attribute: text
+              default: question
+            - name: title
+              path: "#question-header h1 a"
+              attribute: text
+            - name: votes
+              path: "#question .js-vote-count"
+              attribute: text
+              transform: int
+            - name: author
+              path: "#question .post-signature:last-child .user-details a"
+              attribute: text
+              default: Unknown
+            - name: tags
+              path: "#question .post-tag"
+              attribute: text
+              collect: true
+              join: ", "
+            - name: body
+              path: "#question .s-prose.js-post-body"
+              attribute: text
+              truncate: 500
+      - parse:
+          name: answers
+          from: fetch
+          format: html
+          extract: "#answers .answer"
+          fields:
+            - name: type
+              path: ".__web2cli_missing__"
+              attribute: text
+              default: answer
+            - name: title
+              path: ".__web2cli_missing__"
+              attribute: text
+              default: ""
+            - name: votes
+              path: ".js-vote-count"
+              attribute: text
+              transform: int
+            - name: author
+              path: ".post-signature:last-child .user-details a"
+              attribute: text
+              default: Unknown
+            - name: tags
+              path: ".__web2cli_missing__"
+              attribute: text
+              default: ""
+            - name: body
+              path: ".s-prose.js-post-body"
+              attribute: text
+              truncate: 500
+      - transform:
+          name: answers_sorted
+          from: answers
+          ops:
+            - sort:
+                by: votes
+                order: desc
+      - transform:
+          name: parsed
+          from: answers_sorted
+          ops:
+            - concat:
+                steps: [question]
+                position: before
+    output:
+      from_step: parsed
+      default_fields: [type, votes, author, body]
+      default_format: plain
+
+  tagged:
+    description: "Browse questions by tag"
+    args:
+      tag:
+        type: string
+        required: true
+        description: "Tag name (e.g., python, javascript, rust)"
+      sort:
+        type: string
+        required: false
+        default: votes
+        enum: [newest, active, bounties, unanswered, frequent, votes]
+      limit:
+        type: int
+        required: false
+        default: 15
+        max: 50
+    pipeline:
+      - request:
+          name: fetch
+          method: GET
+          url: /questions/tagged/{{args.tag}}
+          params:
+            tab: "{{args.sort}}"
+            pagesize: "{{args.limit}}"
+      - parse:
+          name: parsed
+          from: fetch
+          format: html
+          extract: "div.s-post-summary"
+          fields:
+            - name: id
+              path: "h3 a.s-link"
+              attribute: href
+              transform: int
+            - name: title
+              path: "h3 a.s-link"
+              attribute: text
+            - name: url
+              path: "h3 a.s-link"
+              attribute: href
+              prefix: "https://stackoverflow.com"
+            - name: votes
+              path: "span.s-post-summary--stats-item-number:nth-of-type(1)"
+              attribute: text
+              transform: int
+            - name: answers
+              path: "div.s-post-summary--stats-item:nth-of-type(2) span.s-post-summary--stats-item-number"
+              attribute: text
+              transform: int
+            - name: tags
+              path: "ul.ml0 li a.post-tag"
+              attribute: text
+              collect: true
+              join: ", "
+      - transform:
+          name: sorted
+          from: parsed
+          ops:
+            - sort:
+                by: votes
+                order: desc
+    output:
+      from_step: sorted
+      default_fields: [id, title, votes, answers, tags]
+      default_format: table