Script Updated and enhaced.

.gitignore

@@ -0,0 +1,12 @@
+# Ignore everything
+*
+config.json
+# Allow specific files
+!.gitignore
+!main.py
+!configExample.json
+!README.md
+!LICENCE
+!requirements.txt
+!e2e_tests.py
+!unit_tests.py

LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 dilaratznr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,31 +1,125 @@
 # EasyApply-Linkedin
 
-With this tool you can easily automate the process of applying for jobs on LinkedIn!
+With this tool, you can easily automate the process of applying for jobs on LinkedIn!
 
-## Getting started
+## Getting Started
 
 These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
 
 ### Prerequisites
 
-1. Install selenium. I used `pip` to install the selenium package.
-
-`pip install selenium`
+1. Install Selenium. Use `pip` to install the Selenium package:
+    ```sh
+    pip install selenium
+    ```
 
 2. Selenium requires a driver to interface with the chosen browser. Make sure the driver is in your path, you will need to add your `driver_path` to the `config.json` file.
 
-I used the Chrome driver, you can download it [here](https://sites.google.com/a/chromium.org/chromedriver/downloads). You can also download [Edge](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/), [Firefox](https://github.com/mozilla/geckodriver/releases) or [Safari](https://webkit.org/blog/6900/webdriver-support-in-safari-10/). Depends on your preferred browser.
+    I used the Firefox driver, you can download it [here](https://github.com/mozilla/geckodriver/releases). You can also download drivers for [Chrome](https://sites.google.com/a/chromium.org/chromedriver/downloads), [Edge](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/), or [Safari](https://webkit.org/blog/6900/webdriver-support-in-safari-10/), depending on your preferred browser.
+
+### Installation
+
+1. Clone the repository:
+    ```sh
+    git clone https://github.com/Gabo-Tech/EasyApply-Linkedin.git
+    cd EasyApply-Linkedin
+    ```
+
+2. Install the necessary packages:
+    ```sh
+    pip install -r requirements.txt
+    ```
+
+3. Update the `config.json` file with your information:
+    ```json
+    {
+        "email": "example@example.com",
+        "password": "securePassword123!",
+        "keywords": ["Web Developer", "JavaScript", "React"],
+        "keywordsToAvoid": ["C++", ".NET"],
+        "locations": ["New York", "Los Angeles", "San Francisco"],
+        "driver_path": "/usr/local/bin/geckodriver",
+        "sortBy": "R",
+        "filters": {
+            "easy_apply": true,
+            "experience": ["Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive"],
+            "jobType": ["Full-time", "Part-time", "Contract", "Internship", "Temporary"],
+            "timePostedRange": ["Any Time", "Last Month", "Past Week", "Past 24 hours"],
+            "workplaceType": ["Remote", "Hybrid", "On-site"],
+            "less_than_10_applicants": true
+        }
+    }
+    ```
+
+4. Update the location codes in the script:
+    ```python
+    LOCATION_MAPPING = {
+        "Canada": "101174742",
+        "Portugal": "100364837",
+        "Switzerland": "106693272",
+        "United States": "103644278",
+        "Belgium": "100565514",
+        "Netherlands": "102890719",
+        "DACH": "91000006",
+        "Benelux": "91000005",
+        "European Union": "91000000",
+        "European Economic Area": "91000002",
+        "Germany": "101282230",
+        "Spain": "105646813",
+        "United Kingdom": "101165590"
+    }
+    ```
+    You can find the code in the `geoId` found in the LinkedIn URL after doing a job search. These are the correct ones if you don't want to search elsewhere, but there are many more.
 
 ### Usage
 
-Fork and clone/download the repository and change the configuration file with:
+1. Run the application:
+    ```sh
+    python main.py
+    ```
+
+### Features
+
+- **Automated Job Applications**: Automatically apply to jobs that match your keywords and location.
+- **Filter Options**: Customize filters for experience level, job type, time posted, workplace type, and more.
+- **Logging**: Keep track of errors and the companies you've applied to.
+
+### Customization
+
+You can customize the job search and application process by editing the `config.json` file:
+- **email**: Your LinkedIn email address.
+- **password**: Your LinkedIn password.
+- **keywords**: Keywords for finding specific job titles (e.g., "Machine Learning Engineer", "Data Scientist").
+- **keywordsToAvoid**: Keywords to exclude from your search.
+- **locations**: Locations where you are currently looking for a position.
+- **driver_path**: Path to your downloaded WebDriver.
+- **sortBy**: Sort order for job listings.
+- **filters**: Various filters to narrow down the job search (e.g., easy apply, experience level, job type, etc.).
+
+### Testing
+
+#### Unit Tests
+
+Unit tests mock the Selenium WebDriver to test methods in isolation without making actual web requests.
+
+Run the unit tests:
+```bash
+python unit_tests.py
+```
+
+#### E2E Tests
+
+End-to-end tests using `pytest` and `selenium` require an actual web browser to run.
+
+Run the E2E tests:
+```bash
+pytest e2e_tests.py
+```
+
+### Contributing
 
-* Your email linked to LinkedIn.
-* Your password.
-* Keywords for finding specific job titles fx. Machine Learning Engineer, Data Scientist, etc.
-* The location where you are currently looking for a position.
-* The driver path to your downloaded webdriver.
+Please feel free to comment or give suggestions/issues. Fork and submit pull requests for any enhancements or bug fixes.
 
-Run `python main.py`.
+### License
 
-Please feel free to comment or give suggestions/issues.
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/Gabo-Tech/EasyApply-Linkedin/blob/master/LICENCE) file for details.

configExample.json

@@ -0,0 +1,195 @@
+{
+  "email": "example@domain.com",
+  "password": "YourSecurePassword123!",
+  "keywords": [
+      "TypeScript",
+      "Angular",
+      "React",
+      "React Native",
+      "Node",
+      "JavaScript",
+      "Frontend Engineer",
+      "Full-Stack Engineer",
+      "Backend Engineer"
+  ],
+  "keywordsToAvoid": [
+      "C++",
+      ".NET",
+      "Analyst",
+      "PHP",
+      "Python",
+      "C",
+      "Java",
+      "Go",
+      "Rust",
+      "Kotlin",
+      "Swift",
+      "Objective-C",
+      "Robotic",
+      "Data",
+      "Science",
+      "Cloud",
+      "AI",
+      "ML",
+      "DL",
+      "NLP",
+      "CV",
+      "DevOps",
+      "Solidity"
+  ],
+  "locations": [
+      "Canada",
+      "Portugal",
+      "Switzerland",
+      "Belgium",
+      "Netherlands",
+      "DACH",
+      "Benelux",
+      "European Union",
+      "European Economic Area",
+      "Germany",
+      "Spain",
+      "United States",
+      "United Kingdom"
+  ],
+  "driver_path": "/path/to/geckodriver",
+  "sortBy": "R",
+  "filters": {
+      "easy_apply": true,
+      "experience": [],
+      "jobType": [
+          "Full-time",
+          "Contract"
+      ],
+      "timePostedRange": [],
+      "workplaceType": [
+          "Remote",
+          "Hybrid"
+      ],
+      "less_than_10_applicants": false
+  },
+  "collection": "",
+  "aiContext": {
+      "preferences": {
+          "workplaceType": "Remote",
+          "workplaceTypeAlternative": [
+              "Hybrid"
+          ],
+          "jobType": "Contract",
+          "jobTypeAlternative": [
+              "Full-time"
+          ],
+          "prereferredEnd": "Backend",
+          "prereferredEndAlternative": [
+              "Full-Stack",
+              "Frontend"
+          ]
+      },
+      "currentLocation": "Fake City, Country",
+      "willingToRelocate": true,
+      "experience": [
+          {
+              "title": "Full-Stack Developer",
+              "description": "Developed an e-commerce platform using MERN stack.",
+              "date": "Jan 2021 - Present",
+              "company": "Tech Solutions",
+              "location": "Remote",
+              "skills": [
+                  "TypeScript",
+                  "React",
+                  "Node.js",
+                  "Express.js",
+                  "MongoDB"
+              ]
+          },
+          {
+              "title": "Frontend Engineer",
+              "description": "Designed and implemented user interfaces with Angular.",
+              "date": "Jun 2019 - Dec 2020",
+              "company": "Web Creators",
+              "location": "San Francisco, CA",
+              "skills": [
+                  "JavaScript",
+                  "Angular",
+                  "HTML",
+                  "CSS"
+              ]
+          }
+      ],
+      "education": [
+          {
+              "title": "Bachelor of Science - Computer Science",
+              "description": "Studied various aspects of computer science, including algorithms, data structures, and web development.",
+              "date": "Sep 2015 - Jun 2019",
+              "company": "University of Somewhere",
+              "skills": [
+                  "Algorithms",
+                  "Data Structures",
+                  "Web Development",
+                  "Machine Learning"
+              ]
+          }
+      ],
+      "projects": [
+          {
+              "name": "Project Alpha",
+              "description": "A project management tool developed using React and Node.js.",
+              "technologies": [
+                  "React",
+                  "Node.js",
+                  "Express",
+                  "MongoDB",
+                  "Docker"
+              ]
+          }
+      ],
+      "skills": [
+          "TypeScript",
+          "JavaScript",
+          "Angular",
+          "React",
+          "Node.js",
+          "Express.js",
+          "MongoDB",
+          "HTML",
+          "CSS"
+      ]
+  },
+  "user_inputs": {
+      "United States": {
+          "City\nCity": "Fake City, USA",
+          "What is your gender?\nWhat is your gender?": "Prefer not to say",
+          "Do you consider yourself to be disabled as defined by the Equality Act 2010?": "No",
+          "Do you require any particular arrangements to support you in the recruitment and selection process?": "No",
+          "What is your ethnic origin?\nWhat is your ethnic origin?": "White",
+          "I Agree Terms & Conditions": true,
+          "LinkedIn": true
+      },
+      "Belgium": {
+          "What is your preferred name?": "John Doe",
+          "Do you now, or will you in the future, require visa sponsorship to work for our company in the country this role is advertised for?": "No",
+          "What are your salary expectations?": "60000",
+          "English": true,
+          "City\nCity": "Fake City, Belgium",
+          "I Agree Terms & Conditions": true,
+          "What language(s) do you speak and/or understand? What is your level?": "English, French - fluent",
+          "Are you legally authorized to work in the country of the job?": "Yes"
+      },
+      "Netherlands": {
+          "What is your current location?": "Fake City, Netherlands",
+          "City\nCity": "Fake City, Netherlands",
+          "Legal Name (if different than above)": "John Doe",
+          "How did you hear about this job?": "LinkedIn",
+          "Do you now or will you in the future require immigration sponsorship to work at Company?": "No",
+          "What are your salary expectations?": "65000",
+          "This vacancy is for an internal position and we do not contract freelancers for this position. Do you acknowledge this statement?": "Yes"
+      },
+      "Spain": {
+          "What is your level of proficiency in English?\nWhat is your level of proficiency in English?": "Native or bilingual",
+          "City\nCity": "Fake City, Spain",
+          "Indica tus expectativas salariales frente a un cambio.": "50000",
+          "Are you legally authorized to work in Spain?": "Yes",
+          "What is your salary expectation?": "50000"
+      }
+  }
+}