import sys, json, datetime
sys.path.insert(0, r'C:\Users\tglaubach\repos\pydocmaker\src')

import pydocmaker as pyd

Export reports to Redmine wiki

Build example document to upload

doc = pyd.Doc()
doc.add_chapter('Introduction')
doc.add('dummy text which will be added to the introduction')
doc.add_kw('verbatim', 'def hello_world():\n   print("hello world!")')
doc.add_chapter('Second Chapter')
doc.add_kw('markdown', 'This is my fancy `markdown` text for the Second Chapter')
doc.add_image("https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png")
doc.show()

Introduction

dummy text which will be added to the introduction

def hello_world():
   print("hello world!")

Second Chapter

This is my fancy markdown text for the Second Chapter

image-name: GitHub-Mark-ea2971cee799.png

caption: GitHub-Mark-ea2971cee799.png

Define the connection to our Redmine server

import redminelib

# Replace with your Redmine instance URL, and token
my_server = 'https://your-redmine-instance.com'
my_token = 'your_redmine_token'

redmine = redminelib.Redmine(my_server, key=my_token)

redmine

<class 'redminelib.engines.sync.SyncEngine'>
session setting param='headers' with params[param]={'X-Redmine-API-Key': 'your_redmine_token'}
session setting param='params' with params[param]={}

<redminelib.Redmine at 0x238ca5f6390>

The easy way: upload via .upload_report_to_redmine(...)

page = doc.to_redmine_upload(redmine, 'your-test-project')
# page should be the link to your wiki page
page

The harder way: export and manual upload

# here we can not save to a file, but only return the exported values
text_textile, attachments_lst = doc.to_redmine()

print(text_textile[:100] + '...\n(rest omitted for brevity)')

print('-'*100)
print('Attachments')
print('-'*100)
for a in attachments_lst:
    print(a.get('filename'), type(a.get('path')), a.get('content_type'))

# this we can use to upload to redmine, but not save to a file directly

page_title = 'My Wiki Page'
project_id = 'myproject'


page = redmine.wiki_page.new()
page.project_id = project_id
page.title = page_title

page.text = text_textile
page.uploads = attachments_lst
page.comments = f'updated at {datetime.datetime.now(tz=datetime.timezone.utc).isoformat()}'
page.save()


print("Wiki page created successfully.")