Added the options of searching for remote within locale / country. Also added options to search within a state or province and search within a country supposing one is open to relocation.

Description

Allowed 'city' and 'province_or_state' to be Null - this allows searching country-wide, or if city is not Null but province_or_state is Null, search will be for within the indicated province or state.
Added 'remote_within_country' in settings.yaml to specifically distinguish between searching by remote vs searching by region when province_or_state and/or city are Null.

Example cases in my_settings.yaml: To search entire country if one is willing to relocate anywhere: province_or_state: Null city: Null remote_within_country: False To search within entire province or state (radius will not be accounted): province_or_state: (ie. Scotland) city: Null remote_within_country: False To search entire country for remote roles: province_or_state: Null city: Null remote_within_country: True

Please note: CSV entries organically log the location of the user who posted the job listing, so even when a job is remote, a CSV entry for location still exists, thus '' for entry is unnecessary.

To implement remote for Indeed, location is set to remote.
No such option exists for Monster, but many jobs have the keyword remote in its listing, so setting remote involves adding the keyword remote in search queries.
Monster also has in the past prompted people to search by the keywords 'Work From Home.' However, 'Work From Home' in addition to other keyword queries has returned little results compared to adding the keyword 'remote.'

Please note: Even though 'remote_within_country: ' is set to True, it is not guaranteed within each platform that all jobs will be remote due to promoted listings.

Context of change

Please add options that are relevant and mark any boxes that apply.

[ ] Software (software that runs on the PC)
[ ] Library (library that runs on the PC)
[ ] Tool (tool that assists coding development)
[ ] Other

Type of change

Please mark any boxes that apply.

[ ] Bug fix (non-breaking change which fixes an issue)
[x] New feature (non-breaking change which adds functionality)
[ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
[ ] This change requires a documentation update

How Has This Been Tested?

I tried variations for each locale where remote is enable and Null is indicated to city or province_or_state

Checklist:

Please mark any boxes that have been completed.

[x] I have performed a self-review of my own code.
[x] I have commented my code, particularly in hard-to-understand areas.
[x] I have made corresponding changes to the documentation.
[x] My changes generate no new warnings.
[ ] I have added tests that prove my fix is effective or that my feature works.
[ ] New and existing unit tests pass locally with my changes.
[ ] Any dependent changes have been merged and published in downstream modules.

PaulMcInnis / JobFunnel

Implemented Remote, Search within State or Province, and Search within Country #113