python-jobspy-damarowen 1.2.0__tar.gz → 1.2.2__tar.gz

python_jobspy_damarowen-1.2.2/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.2] - 2026-07-19
+
+### Added
+- `CHANGELOG.md` to track changes between releases and display them on PyPI.
+
+### Changed
+- `pyproject.toml` now reads release notes from `CHANGELOG.md` for PyPI release history.
+
+## [1.2.1] - 2026-07-19
+
+### Changed
+- Expanded JobStreet Tangerang location filter to include Serpong, BSD, Alam Sutera, Tangerang Selatan, Kabupaten Tangerang, Kota Tangerang, and surrounding Banten areas.
+
+## [1.2.0] - 2026-07-19
+
+### Added
+- Initial fork release as `python-jobspy-damarowen`.
+- JobStreet Indonesia scraper (`site_name="jobstreet"`).
+- README with usage examples, engine integration guide, and development workflow.
+
+### Changed
+- Package metadata updated for fork publication on PyPI.

python_jobspy_damarowen-1.2.0/README.md → python_jobspy_damarowen-1.2.2/PKG-INFO

@@ -1,3 +1,30 @@
+Metadata-Version: 2.4
+Name: python-jobspy-damarowen
+Version: 1.2.2
+Summary: Job scraper for LinkedIn, Indeed, Glassdoor, ZipRecruiter, Bayt, and JobStreet (Indonesia fork)
+License-File: LICENSE
+Keywords: jobs-scraper,jobstreet,linkedin,indeed,glassdoor,ziprecruiter,bayt,naukri
+Author: Cullen Watson
+Author-email: cullen@cullenwatson.com
+Requires-Python: >=3.10,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: beautifulsoup4 (>=4.12.2,<5.0.0)
+Requires-Dist: markdownify (>=1.1.0,<2.0.0)
+Requires-Dist: numpy (>=1.26.0)
+Requires-Dist: pandas (>=2.1.0,<3.0.0)
+Requires-Dist: pydantic (>=2.3.0,<3.0.0)
+Requires-Dist: regex (>=2024.4.28,<2025.0.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: tls-client (>=1.0.1,<2.0.0)
+Project-URL: Homepage, https://github.com/damarowen/JobSpy
+Project-URL: Repository, https://github.com/damarowen/JobSpy
+Description-Content-Type: text/markdown
+
 <img src="https://github.com/cullenwatson/JobSpy/assets/78247585/ae185b7e-e444-4712-8bb9-fa97f53e896b" width="400">
 
 **JobSpy** is a job scraping library with the goal of aggregating all the jobs from popular job boards with one tool.
@@ -54,6 +81,114 @@ zip_recruiter Software Developer                 TEKsystems        Phoenix
 
 ```
 
+## Using JobSpy as a Scraping Engine
+
+This package is published to PyPI as `python-jobspy-damarowen` and can be used as the scraping engine inside your own API or application.
+
+### Installation
+
+```bash
+pip install python-jobspy-damarowen==1.2.0
+```
+
+### Import and Scrape
+
+```python
+from jobspy import scrape_jobs
+
+jobs = scrape_jobs(
+    site_name="jobstreet",
+    search_term="software engineer",
+    location="Jakarta",
+    results_wanted=10,
+    hours_old=24,
+    verbose=0,
+)
+
+print(f"Found {len(jobs)} jobs")
+print(jobs.to_dict(orient="records"))
+```
+
+### FastAPI Example
+
+```python
+from fastapi import FastAPI
+from jobspy import scrape_jobs
+
+app = FastAPI()
+
+@app.post("/scrape")
+def scrape(
+    site_name: str = "jobstreet",
+    search_term: str = "software engineer",
+    location: str | None = None,
+    results_wanted: int = 10,
+    hours_old: int | None = None,
+):
+    kwargs = {
+        "site_name": site_name,
+        "search_term": search_term,
+        "results_wanted": results_wanted,
+        "verbose": 0,
+    }
+    if location:
+        kwargs["location"] = location
+    if hours_old is not None:
+        kwargs["hours_old"] = hours_old
+
+    jobs = scrape_jobs(**kwargs)
+    return {
+        "total": len(jobs),
+        "jobs": jobs.to_dict(orient="records"),
+    }
+```
+
+### JobStreet Indonesia Notes
+
+- Use `site_name="jobstreet"` to scrape JobStreet Indonesia.
+- `location` accepts Indonesian city names such as `Jakarta`, `Tangerang`, `Bandung`, `Surabaya`, or `Yogyakarta`.
+- If `location` is omitted, the search defaults to `Indonesia` (nationwide).
+- For `hours_old`, the scraper maps the value to JobStreet's server-side `daterange` filter (1, 3, 7, 14, or 30 days).
+
+## Development & Release Workflow
+
+### Day-to-Day Development
+
+You can push commits to GitHub as often as needed without changing the package version:
+
+```bash
+git add -A
+git commit -m "fix(jobstreet): improve location slug handling"
+git push origin main
+```
+
+No PyPI release is required for normal development commits.
+
+### Releasing a New Version
+
+1. **Bump the version** in [`pyproject.toml`](pyproject.toml) following [Semantic Versioning](https://semver.org/):
+   - `1.2.0` → `1.2.1` for bug fixes
+   - `1.2.0` → `1.3.0` for new features
+   - `1.2.0` → `2.0.0` for breaking changes
+
+2. **Commit the version bump**:
+   ```bash
+   git add pyproject.toml
+   git commit -m "chore(release): bump version to 1.2.1"
+   git push origin main
+   ```
+
+3. **Build and upload to PyPI**:
+   ```bash
+   python -m build
+   twine upload dist/*
+   ```
+
+4. **Update downstream projects** (e.g., `jobspy-api`) to use the new version:
+   ```txt
+   python-jobspy-damarowen==1.2.1
+   ```
+
 ### Parameters for `scrape_jobs()`
 
 ```plaintext
@@ -258,3 +393,34 @@ Naukri specific
 ├── vacancy_count
 └── work_from_home_type
 ```
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.2] - 2026-07-19
+
+### Added
+- `CHANGELOG.md` to track changes between releases and display them on PyPI.
+
+### Changed
+- `pyproject.toml` now reads release notes from `CHANGELOG.md` for PyPI release history.
+
+## [1.2.1] - 2026-07-19
+
+### Changed
+- Expanded JobStreet Tangerang location filter to include Serpong, BSD, Alam Sutera, Tangerang Selatan, Kabupaten Tangerang, Kota Tangerang, and surrounding Banten areas.
+
+## [1.2.0] - 2026-07-19
+
+### Added
+- Initial fork release as `python-jobspy-damarowen`.
+- JobStreet Indonesia scraper (`site_name="jobstreet"`).
+- README with usage examples, engine integration guide, and development workflow.
+
+### Changed
+- Package metadata updated for fork publication on PyPI.
+

python_jobspy_damarowen-1.2.0/PKG-INFO → python_jobspy_damarowen-1.2.2/README.md

@@ -1,30 +1,3 @@
-Metadata-Version: 2.4
-Name: python-jobspy-damarowen
-Version: 1.2.0
-Summary: Job scraper for LinkedIn, Indeed, Glassdoor, ZipRecruiter, Bayt, and JobStreet (Indonesia fork)
-License-File: LICENSE
-Keywords: jobs-scraper,jobstreet,linkedin,indeed,glassdoor,ziprecruiter,bayt,naukri
-Author: Cullen Watson
-Author-email: cullen@cullenwatson.com
-Requires-Python: >=3.10,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: beautifulsoup4 (>=4.12.2,<5.0.0)
-Requires-Dist: markdownify (>=1.1.0,<2.0.0)
-Requires-Dist: numpy (>=1.26.0)
-Requires-Dist: pandas (>=2.1.0,<3.0.0)
-Requires-Dist: pydantic (>=2.3.0,<3.0.0)
-Requires-Dist: regex (>=2024.4.28,<2025.0.0)
-Requires-Dist: requests (>=2.31.0,<3.0.0)
-Requires-Dist: tls-client (>=1.0.1,<2.0.0)
-Project-URL: Homepage, https://github.com/damarowen/JobSpy
-Project-URL: Repository, https://github.com/damarowen/JobSpy
-Description-Content-Type: text/markdown
-
 <img src="https://github.com/cullenwatson/JobSpy/assets/78247585/ae185b7e-e444-4712-8bb9-fa97f53e896b" width="400">
 
 **JobSpy** is a job scraping library with the goal of aggregating all the jobs from popular job boards with one tool.
@@ -81,6 +54,114 @@ zip_recruiter Software Developer                 TEKsystems        Phoenix
 
 ```
 
+## Using JobSpy as a Scraping Engine
+
+This package is published to PyPI as `python-jobspy-damarowen` and can be used as the scraping engine inside your own API or application.
+
+### Installation
+
+```bash
+pip install python-jobspy-damarowen==1.2.0
+```
+
+### Import and Scrape
+
+```python
+from jobspy import scrape_jobs
+
+jobs = scrape_jobs(
+    site_name="jobstreet",
+    search_term="software engineer",
+    location="Jakarta",
+    results_wanted=10,
+    hours_old=24,
+    verbose=0,
+)
+
+print(f"Found {len(jobs)} jobs")
+print(jobs.to_dict(orient="records"))
+```
+
+### FastAPI Example
+
+```python
+from fastapi import FastAPI
+from jobspy import scrape_jobs
+
+app = FastAPI()
+
+@app.post("/scrape")
+def scrape(
+    site_name: str = "jobstreet",
+    search_term: str = "software engineer",
+    location: str | None = None,
+    results_wanted: int = 10,
+    hours_old: int | None = None,
+):
+    kwargs = {
+        "site_name": site_name,
+        "search_term": search_term,
+        "results_wanted": results_wanted,
+        "verbose": 0,
+    }
+    if location:
+        kwargs["location"] = location
+    if hours_old is not None:
+        kwargs["hours_old"] = hours_old
+
+    jobs = scrape_jobs(**kwargs)
+    return {
+        "total": len(jobs),
+        "jobs": jobs.to_dict(orient="records"),
+    }
+```
+
+### JobStreet Indonesia Notes
+
+- Use `site_name="jobstreet"` to scrape JobStreet Indonesia.
+- `location` accepts Indonesian city names such as `Jakarta`, `Tangerang`, `Bandung`, `Surabaya`, or `Yogyakarta`.
+- If `location` is omitted, the search defaults to `Indonesia` (nationwide).
+- For `hours_old`, the scraper maps the value to JobStreet's server-side `daterange` filter (1, 3, 7, 14, or 30 days).
+
+## Development & Release Workflow
+
+### Day-to-Day Development
+
+You can push commits to GitHub as often as needed without changing the package version:
+
+```bash
+git add -A
+git commit -m "fix(jobstreet): improve location slug handling"
+git push origin main
+```
+
+No PyPI release is required for normal development commits.
+
+### Releasing a New Version
+
+1. **Bump the version** in [`pyproject.toml`](pyproject.toml) following [Semantic Versioning](https://semver.org/):
+   - `1.2.0` → `1.2.1` for bug fixes
+   - `1.2.0` → `1.3.0` for new features
+   - `1.2.0` → `2.0.0` for breaking changes
+
+2. **Commit the version bump**:
+   ```bash
+   git add pyproject.toml
+   git commit -m "chore(release): bump version to 1.2.1"
+   git push origin main
+   ```
+
+3. **Build and upload to PyPI**:
+   ```bash
+   python -m build
+   twine upload dist/*
+   ```
+
+4. **Update downstream projects** (e.g., `jobspy-api`) to use the new version:
+   ```txt
+   python-jobspy-damarowen==1.2.1
+   ```
+
 ### Parameters for `scrape_jobs()`
 
 ```plaintext
@@ -285,4 +366,3 @@ Naukri specific
 ├── vacancy_count
 └── work_from_home_type
 ```
-

{python_jobspy_damarowen-1.2.0 → python_jobspy_damarowen-1.2.2}/jobspy/jobstreet/__init__.py

@@ -166,6 +166,30 @@ class JobStreet(Scraper):
 
         jobs = []
         requested_location = (self.scraper_input.location or "Indonesia").strip().lower()
+        # Expand "Tangerang" to cover the whole Tangerang metropolitan area
+        location_matchers = {
+            "tangerang": {
+                "tangerang",
+                "serpong",
+                "bsd",
+                "alam sutera",
+                "cipondoh",
+                "ciledug",
+                "batuceper",
+                "benda",
+                "jatiuwung",
+                "karawaci",
+                "larangan",
+                "periuk",
+                "pinang",
+                "tangerang selatan",
+                "kabupaten tangerang",
+                "kota tangerang",
+                "banten",
+            }
+        }
+        accepted_matchers = location_matchers.get(requested_location, {requested_location})
+
         for card in job_cards:
             try:
                 job = self._parse_card(card)
@@ -176,7 +200,7 @@ class JobStreet(Scraper):
                             getattr(job.location, field, "") or ""
                             for field in ("city", "state", "country")
                         ).lower()
-                        if requested_location not in job_location:
+                        if not any(matcher in job_location for matcher in accepted_matchers):
                             log.debug(f"Skipping job '{job.title}' in '{job_location}' (requested {requested_location})")
                             continue
                     jobs.append(job)

{python_jobspy_damarowen-1.2.0 → python_jobspy_damarowen-1.2.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "python-jobspy-damarowen"
-version = "1.2.0"
+version = "1.2.2"
 description = "Job scraper for LinkedIn, Indeed, Glassdoor, ZipRecruiter, Bayt, and JobStreet (Indonesia fork)"
 authors = ["Cullen Watson <cullen@cullenwatson.com>", "Zachary Hampton <zachary@zacharysproducts.com>", "Damarowen"]
 homepage = "https://github.com/damarowen/JobSpy"
 repository = "https://github.com/damarowen/JobSpy"
-readme = "README.md"
+readme = [ "README.md", "CHANGELOG.md",]
 keywords = [ "jobs-scraper", "jobstreet", "linkedin", "indeed", "glassdoor", "ziprecruiter", "bayt", "naukri"]
 [[tool.poetry.packages]]
 include = "jobspy"