enh: init

Author: cullenwatson

.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,10 @@
+/venv/
+/.idea
+**/__pycache__/
+**/.pytest_cache/
+/.ipynb_checkpoints/
+**/output/
+**/.DS_Store
+*.pyc
+.env
+dist

.gitignore

@@ -0,0 +1,7 @@
+repos:
+- repo: https://github.com/psf/black
+  rev: 24.2.0
+  hooks:
+  - id: black
+    language_version: python
+    args: [--line-length=88, --quiet]

.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Cullen Watson
+
+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.

LICENSE

@@ -0,0 +1,72 @@
+**StaffSpy** is a LinkediIn staff scraping library.
+
+## Features
+
+- Scrapes all staff from a company on **LinkedIn** using given criteria
+- Aggregates the employees in a Pandas DataFrame
+
+### Installation
+
+```
+pip install -U staffspy
+```
+
+_Python version >= [3.10](https://www.python.org/downloads/release/python-3100/) required_
+
+
+### Usage
+
+```python
+from staffspy import scrape_jobs
+
+staff = scrape_staff(
+    company="openai" 
+    
+    # opional filters
+    # search_term="software engineer",
+    # location="Dallas, TX",
+    # results_wanted=20,
+)
+print(f"Found {len(staff)} staff")
+print(staff.head())
+staff.to_csv("jobs.csv", index=False)
+```
+A browser will open to sign in to LinkedIn. Press enter after signing in to begin scraping. Ctrl-c to stop scraping.
+
+### Staff Schema
+
+```plaintext
+Staff
+├── name
+├── username
+├── about
+├── skills
+├── location
+├── experiences
+│   ├── position
+│   ├── company
+│   ├── location
+│   ├── duration
+│   ├── from_date
+│   └── to_date
+├── educations
+    ├── school_name
+    ├── degree
+    ├── location
+    ├── duration
+    ├── from_date
+    └── to_date
+```
+
+
+## Frequently Asked Questions
+
+---
+
+**Q: Can I get my account banned?**  
+**A:** It is a possiblity, although it has not happened to me. Use at your own risk.
+
+**Q: Too many staff at a company?**  
+**A:** Try using the filters to find the type of staff you are looking for. If problems
+persist, [submit an issue](https://github.com/cullenwatson/StaffSpy/issues).
+---

README.md

@@ -0,0 +1,16 @@
+# This is a sample Python script.
+
+# Press ⌃R to execute it or replace it with your code.
+# Press Double ⇧ to search everywhere for classes, files, tool windows, actions, and settings.
+
+
+def print_hi(name):
+    # Use a breakpoint in the code line below to debug your script.
+    print(f'Hi, {name}')  # Press ⌘F8 to toggle the breakpoint.
+
+
+# Press the green button in the gutter to run the script.
+if __name__ == '__main__':
+    print_hi('PyCharm')
+
+# See PyCharm help at https://www.jetbrains.com/help/pycharm/