Async function doesn't work at all

[brianshen1990]

Problem:
Updating 20 cases without async takes about 100 seconds .
So I try async, But the total time doesn't change at all, and every update still makes me wait about 5 seconds. It should be faster, right?

Belowing is how i use async function.

### How i init: 
  _jiraConnection = JIRA(
    options={
      'server': config.JiraServer(),
      'verify': False,
    },
    basic_auth=(
      config.JiraUser(),
      config.JiraPwd(),
    ),
    async_=True,
    async_workers=10
  )

### How i update 
    jiraIssue.update( description = description, 
        fields= {f'{config.JiraMANUAl_INSPECTION_ID()}': config.JiraMANUAL_INSPECTION_NO() }, 
        async_=True) 

### Every 10 tasks, I will call 
def do_all_async_jobs():
  jira = get_connection()
  jira.async_do()

Doesn't work at all, so could anyone help?

[anthonyjso]

@brianshen1990

I ran into this issue as well and found https://github.com/pycontribs/jira/blob/2.0.0/jira/client.py#L562

https://github.com/ross/requests-futures is required. The client attempts to import and eats the import failure silently.

Looking in https://github.com/pycontribs/jira/blob/2.0.0/setup.cfg#L54 shows that an undocumented extras dependency can be installed via:

pip install jira --install-option="--extras-require=async"

[emilyastranova]

if self._options['async']:
            try:
                from requests_futures.sessions import FuturesSession
                async_class = FuturesSession
            except ImportError:
                pass

This should probably log to the console that you have manually specified async_=True and it is falling back to synchronous due to an import error.

Also need to document that pip install process. I tried pip install jira --install-option="--extras-require=async" with no luck, I think maybe it has been modified since?

Pretty sure the command is pip install jira[async] now. That is what pulled requests-futures for me.

[emilyastranova]

I will also add that the async code could use some serious cleanup, I may be able to contribute some time to it but goodness it is something