pyjstage2 0.1.2__py3-none-any.whl

pyjstage/__init__.py

@@ -0,0 +1 @@
+from .pyjstage import Pyjstage

pyjstage/entry.py

@@ -0,0 +1,76 @@
+class Entry:
+    """Base class for Entry
+
+    Attributes:
+        issn: ISSN
+        eissn: eISSN
+        cdjournal: journal name
+        material_title: journal title
+        volume: journal volume
+        number: journal number
+        starting_page: starting page this document is.
+        pubyear: Published year.
+        systemcode: System code
+        systemname: System name
+        title: Title
+        link: Link
+        id: ID, it is always the same as link parameter.
+        updated: updated date
+    """
+    def __init__(self):
+        """Initialize Entry class"""
+        self.issn = None
+        self.eissn = None
+        self.cdjournal = None
+        self.material_title = None
+        self.volume = None
+        self.number = None
+        self.starting_page = None
+        self.pubyear = None
+        self.systemcode = None
+        self.systemname = None
+        self.title = None
+        self.link = None
+        self.id = None
+        self.updated = None
+
+    def __str__(self):
+        return str(self.__dict__.items())
+
+
+class ListEntry(Entry):
+    """Entry class for List API
+
+    Attributes:
+        vols_title: volumes title
+        vols_link: volumes link
+        publisher_name: publisher name
+        publisher_url: publisher url
+    """
+    def __init__(self):
+        """Initialize ListEntry class"""
+        super().__init__()
+        self.vols_title = {}
+        self.vols_link = {}
+        self.publisher_name = None
+        self.publisher_url = {}
+
+
+class SearchEntry(Entry):
+    """Entry class for Search API
+
+    Attributes:
+        article_title: article title
+        article_link: article link
+        author: article author
+        ending_page: ending page
+        doi: DOI
+    """
+    def __init__(self):
+        """Initialize SearchEntry class"""
+        super().__init__()
+        self.article_title = {}
+        self.article_link = None
+        self.author = None
+        self.ending_page = None
+        self.doi = None

pyjstage/errors.py

@@ -0,0 +1,78 @@
+class JstageError(Exception):
+    """Abstract class for errors caused by J-STAGE API"""
+    pass
+
+
+class JstageWarning(Warning):
+    """Abstract class for warnings caused by J-STAGE API"""
+    pass
+
+
+class NoResultsError(JstageError):
+    """ERR_001"""
+    pass
+
+
+class TooManyResultsError(JstageWarning):
+    """WARN_001"""
+    pass
+
+
+class TooManyRequestsError(JstageError):
+    """ERR_003"""
+    pass
+
+
+class InvalidQueryError(JstageError):
+    """ERR_004"""
+    pass
+
+
+class EmptyRequiredFieldError(JstageError):
+    """ERR_005"""
+    pass
+
+
+class InvalidYearValueError(JstageError):
+    """ERR_006"""
+    pass
+
+
+class InvalidCountsError(JstageError):
+    """ERR_007"""
+    pass
+
+
+class InvalidIssnError(JstageError):
+    """ERR_008"""
+    pass
+
+
+class SystemFatalError(JstageError):
+    """SYS_ERR_009"""
+    pass
+
+
+class InvalidUrlError(JstageError):
+    """ERR_010"""
+    pass
+
+
+class ListNoQueryError(JstageError):
+    """ERR_011"""
+    pass
+
+
+class SearchNoQueryError(JstageError):
+    """ERR_012"""
+    pass
+
+
+class ListUnspecifiedError(JstageError):
+    """ERR_013"""
+    pass
+
+
+class SearchUnsortableError(JstageError):
+    """ERR_014"""
+    pass

pyjstage/order.py

@@ -0,0 +1,21 @@
+from enum import Enum
+
+
+class ListOrder(Enum):
+    """Enum for list's order
+
+    ListOrder.ASCENDING: sort by ascending
+    ListOrder.DESCENDING: sort by descending
+    """
+    ASCENDING = 1
+    DESCENDING = 2
+
+
+class SearchOrder(Enum):
+    """Enum for search's order
+
+    SearchOrder.SCORE: sort by score
+    SearchOrder.NUMBER: sort by number ascending
+    """
+    SCORE = 1
+    NUMBER = 2

pyjstage/parser.py

@@ -0,0 +1,56 @@
+from lxml import etree
+from .result import Result, ListResult, SearchResult
+from .status import Status
+from datetime import datetime
+import re
+
+
+class Parser:
+    """Parser Class"""
+    def __init__(self):
+        """Initialize Parser class"""
+        self.regex = re.compile(r'\n* +')
+
+    def parse(self, xml_text: bytes) -> Result:
+        """Parse XML returned from J-STAGE API
+
+        Parse XML document (as bytes object) into Result object.
+        This function may raise Error or Warning.
+        If that error starts with Jstage, that error was occurred by J-STAGE.
+
+        Args:
+            xml_text: raw xml text's bytes encoded by UTF-8
+        Returns:
+            Result object which contains meta data and contents.
+        Raises:
+            JstageError: error depending on j-stage api
+            JstageWarning: warning depending on j-stage api
+        """
+        result = Result()
+
+        root = etree.fromstring(xml_text)
+        result.xmlns = root.nsmap
+        result.xmlns['xml'] = 'http://www.w3.org/XML/1998/namespace'
+        result.xml_lang = root.find('[@xml:lang]', result.xmlns).attrib.values()[0]
+        result.xml_version = etree.ElementTree(root).docinfo.xml_version
+        result.encoding = etree.ElementTree(root).docinfo.encoding
+        result.servicecd = int(root.find('./servicecd', result.xmlns).text)
+        result.title = root.find('./title', result.xmlns).text
+        result.link = self.regex.sub('', root.find('./link', result.xmlns).attrib['href'])
+        result.id = self.regex.sub('', root.find('./id', result.xmlns).text)
+        result.updated = datetime.fromisoformat(root.find('./updated', result.xmlns).text)
+        result.total_results = int(root.find('./opensearch:totalResults', result.xmlns).text)
+        result.start_index = int(root.find('./opensearch:startIndex', result.xmlns).text)
+        result.items_per_page = int(root.find('./opensearch:itemsPerPage', result.xmlns).text)
+        result.entries = list(root.findall('./entry', result.xmlns))
+        result.status = root.find('./result/status', result.xmlns).text
+        result.message = root.find('./result/message', result.xmlns).text
+        Status.divide(result.status, result.message)
+        if result.servicecd == 2:
+            rresult = ListResult(result)
+        elif result.servicecd == 3:
+            rresult = SearchResult(result)
+        else:
+            raise Exception('Undefined service code')
+
+        return rresult

pyjstage/pyjstage.py

@@ -0,0 +1,153 @@
+from .result import Result
+from .parser import Parser
+from .service import Service
+from .order import ListOrder, SearchOrder
+from urllib.parse import quote
+from typing import List, Union
+import requests
+
+
+class Pyjstage:
+    """Pyjstage Class
+
+    Attributes:
+        domain: J-STAGE API domain
+        parser: Parser object
+    """
+    def __init__(self, domain: str = 'http://api.jstage.jst.go.jp/searchapi/do?'):
+        """Initialize Pyjstage class
+
+        Args:
+            domain: (Optional) J-STAGE API domain
+        """
+        self.domain: str = domain
+        self.parser: Parser = Parser()
+
+    def list(
+            self,
+            pubyearfrom: int = None,
+            pubyearto: int = None,
+            material: Union[str, List[str]] = None,
+            issn: str = None,
+            cdjournal: str = None,
+            volorder: ListOrder = None
+    ) -> Result:
+        """Access LIST API
+
+        Access LIST API and parse result as ListResult Object.
+        Union[xxx, List[xxx]] arguments can multiple value as list object.
+        If you set that argument as list, Search as 'AND'
+
+        Args:
+            pubyearfrom: (Optional) Year you want to search when papers were published from.
+            pubyearto: (Optional) Year you want to search when papers were published to.
+            material: (Optional) Keyword journal should contain.
+            issn: (Optional) ISSN you want to search.
+            cdjournal: (Optional) Journal code you want to search.
+            volorder: (Optional) How order are responses sorted.
+        Returns:
+            ListResult object which contains meta data and contents
+        Raises:
+            JstageError: Error caused by J-STAGE API
+            JstageWarning: Warning caused by J-STAGE API
+        """
+        url = self.build_query(
+            service=Service.LIST.value,
+            pubyearfrom=pubyearfrom,
+            pubyearto=pubyearto,
+            material=material,
+            issn=issn,
+            cdjournal=cdjournal,
+            volorder=volorder.value)
+        response = requests.get(url)
+        return self.parser.parse(response.text.encode('utf-8'))
+
+    def search(
+            self,
+            pubyearfrom: int = None,
+            pubyearto: int = None,
+            material: Union[str, List[str]] = None,
+            article: Union[str, List[str]] = None,
+            author: Union[str, List[str]] = None,
+            affile: Union[str, List[str]] = None,
+            keyword: Union[str, List[str]] = None,
+            abst: Union[str, List[str]] = None,
+            text: Union[str, List[str]] = None,
+            issn: str = None,
+            cdjournal: str = None,
+            sortfig: SearchOrder = None,
+            vol: int = None,
+            no: int = None,
+            start: int = None,
+            count: int = None
+    ) -> Result:
+        """Access SEARCH API
+
+        Access SEARCH API and parse result as SearchResult Object.
+        Union[xxx, List[xxx]] arguments can multiple value as list object.
+        If you set that argument as list, Search as 'AND'
+
+        Args:
+            pubyearfrom: (Optional) Year you want to search when papers were published from.
+            pubyearto: (Optional) Year you want to search when papers were published to.
+            material: (Optional) Keyword journal should contain.
+            article: Keyword document's title should contain.
+            author: Keyword document's author name should contain.
+            affile: Keyword document's author's affile name should contain.
+            keyword: Keyword document's keyword should contain.
+            abst: Keyword document's abstract should contain.
+            text: Keyword document's body should contain
+            issn: (Optional) ISSN you want to search.
+            cdjournal: (Optional) Journal code you want to search.
+            sortfig: How order are responses sorted.
+            vol: What volume is document contained in journal
+            no: What number is document contained in journal
+            start: How many offsets you want to set, default 0.
+            count: How many results you want to fetch, max & default is 1000.
+        Returns:
+            SearchResult object which contains meta data and contents
+        Raises:
+            xxxError: xxx
+        """
+        url = self.build_query(
+            service=Service.SEARCH.value,
+            pubyearfrom=pubyearfrom,
+            pubyearto=pubyearto,
+            material=material,
+            article=article,
+            author=author,
+            affile=affile,
+            keyword=keyword,
+            abst=abst,
+            text=text,
+            issn=issn,
+            cdjournal=cdjournal,
+            sortfig=sortfig.value if sortfig else None,
+            vol=vol,
+            no=no,
+            start=start,
+            count=count
+        )
+        response = requests.get(url)
+        result = self.parser.parse(response.text.encode('utf-8'))
+        return result
+
+    def build_query(self, **kwargs):
+        """Build url with queries
+
+        Args:
+            kwargs: key-value pairs for querying. If multiple values, use list.
+        Returns:
+            URL-string which can access J-STAGE API
+        """
+        return self.domain + '&'.join(
+            [
+                f'{quote(k, encoding="utf8")}={quote(str(v) if type(v) is not list else " ".join(v), encoding="utf8")}'
+                for k, v in kwargs.items() if v is not None
+            ]
+        )
+
+if __name__ == '__main__':
+    pj = Pyjstage()
+    ret = pj.search(text=['統合失調症', '精神分裂病'], count=10)
+    print(ret)

pyjstage/result.py

@@ -0,0 +1,228 @@
+from typing import Dict, Optional, List
+import re
+from datetime import datetime
+from .entry import ListEntry, SearchEntry
+from lxml import etree
+
+def _safe_text(el, default=''):
+    """Extract text from an element, handling None and empty tags."""
+    if el is None:
+        return default
+    text = el.text
+    return text.replace('\n', '').strip() if text else default
+
+
+def _safe_int(el, default=0):
+    """Extract integer from an element, handling None/empty/non-numeric."""
+    text = _safe_text(el)
+    if not text:
+        return default
+    try:
+        return int(text)
+    except (ValueError, TypeError):
+        return default
+
+
+def _lang_dict(parent, xmlns):
+    """Build {lang: text} dict from child elements, handling empty tags."""
+    if parent is None:
+        return {}
+    regex = re.compile(r'{.+\}')
+    return {
+        regex.sub('', t.tag): _safe_text(t)
+        for t in parent
+    }
+
+
+class Result:
+    """Base class for Result
+    Attributes:
+        encoding: Document encoding, it may always be utf-8.
+        xml_version: XML version.
+        xmlns: What namespaces does this document refer.
+        xml_lang: What language is this document written in.
+        status: Status code.
+        message: Status message.
+        title: returned title
+        link: returned link
+        id: document id, it is always same as link value.
+        servicecd: API service code, 2 is list and 3 is search.
+        updated: When was this document updated.
+        total_results: How many results did API return.
+        start_index: What index do results starts.
+        items_per_page: How many items does a page contain.
+        entries: Entries API returned.
+    """
+    def __init__(self):
+        self.encoding: Optional[str] = None
+        self.xml_version: Optional[str] = None
+        self.xmlns: Dict[str, str] = {}
+        self.xml_lang: Optional[str] = None
+        self.status: str = Optional[None]
+        self.message: Optional[str] = None
+        self.title: Optional[str] = None
+        self.link: Optional[str] = None
+        self.id: Optional[str] = None
+        self.servicecd: Optional[str] = None
+        self.updated: Optional[datetime] = None
+        self.total_results: Optional[int] = None
+        self.start_index: Optional[int] = None
+        self.items_per_page: Optional[int] = None
+        self.entries: List[etree] = []
+        self.entries_temp: List[etree] = []
+
+    def _finish_setup(self):
+        """remove unused temporary attribute"""
+        del self.entries_temp
+
+    def __str__(self):
+        return str(self.__dict__.items())
+
+
+class SearchResult(Result):
+    """Search Result Class
+
+    Attributes:
+        encoding: Document encoding, it may always be utf-8.
+        xml_version: XML version.
+        xmlns: What namespaces does this document refer.
+        xml_lang: What language is this document written in.
+        status: Status code.
+        message: Status message.
+        title: returned title
+        link: returned link
+        id: document id, it is always same as link value.
+        servicecd: API service code, 2 is list and 3 is search.
+        updated: When was this document updated.
+        total_results: How many results did API return.
+        start_index: What index do results starts.
+        items_per_page: How many items does a page contain.
+        entries: Entries API returned.
+    """
+    def __init__(self, result: Result):
+        """Initialize SearchResult class
+
+        Args:
+            result: Result object
+        """
+        super().__init__()
+        self.encoding = result.encoding
+        self.xml_version = result.xml_version
+        self.xmlns = result.xmlns
+        self.xml_lang = result.xml_lang
+        self.status = result.status
+        self.message = result.message
+        self.title = result.title
+        self.link = result.link
+        self.id = result.id
+        self.servicecd = result.servicecd
+        self.updated = result.updated
+        self.total_results = result.total_results
+        self.start_index = result.start_index
+        self.items_per_page = result.items_per_page
+        self.entries_temp = result.entries
+        self.entries = []
+
+        for e in self.entries_temp:
+            ent = SearchEntry()
+            ent.article_title = _lang_dict(e.find('./article_title', self.xmlns), self.xmlns)
+            ent.article_link = _lang_dict(e.find('./article_link', self.xmlns), self.xmlns)
+            author_el = e.find('./author', self.xmlns)
+            if author_el is not None:
+                ent.author = {}
+                regex = re.compile(r'{.+\}')
+                for t in author_el:
+                    children = list(t)
+                    ent.author[regex.sub('', t.tag)] = _safe_text(children[0]) if children else ''
+            else:
+                ent.author = {}
+            ent.cdjournal = _safe_text(e.find('./cdjournal', self.xmlns))
+            ent.material_title = _lang_dict(e.find('./material_title', self.xmlns), self.xmlns)
+            ent.issn = _safe_text(e.find('./prism:issn', self.xmlns))
+            ent.eissn = _safe_text(e.find('./prism:eIssn', self.xmlns))
+            ent.volume = _safe_int(e.find('./prism:volume', self.xmlns))
+            ent.number = _safe_int(e.find('./prism:number', self.xmlns))
+            ent.starting_page = _safe_text(e.find('./prism:startingPage', self.xmlns))
+            ent.ending_page = _safe_text(e.find('./prism:endingPage', self.xmlns))
+            ent.pubyear = _safe_text(e.find('./pubyear', self.xmlns))
+            ent.doi = _safe_text(e.find('./prism:doi', self.xmlns))
+            ent.systemcode = _safe_int(e.find('./systemcode', self.xmlns))
+            ent.systemname = _safe_text(e.find('./systemname', self.xmlns))
+            ent.title = _safe_text(e.find('./title', self.xmlns))
+            link_el = e.find('./link', self.xmlns)
+            ent.link = (link_el.attrib.get('href', '').replace('\n', '').strip()) if link_el is not None else ''
+            ent.id = _safe_text(e.find('./id', self.xmlns))
+            updated_text = _safe_text(e.find('./updated', self.xmlns))
+            ent.updated = datetime.fromisoformat(updated_text) if updated_text else None
+            self.entries.append(ent)
+        self._finish_setup()
+
+
+class ListResult(Result):
+    """List Result Class
+
+    Attributes:
+        encoding: Document encoding, it may always be utf-8.
+        xml_version: XML version.
+        xmlns: What namespaces does this document refer.
+        xml_lang: What language is this document written in.
+        status: Status code.
+        message: Status message.
+        title: returned title
+        link: returned link
+        id: document id, it is always same as link value.
+        servicecd: API service code, 2 is list and 3 is search.
+        updated: When was this document updated.
+        total_results: How many results did API return.
+        start_index: What index do results starts.
+        items_per_page: How many items does a page contain.
+        entries: Entries API returned.
+    """
+    def __init__(self, result: Result = None):
+        """Initialize ListResult class
+
+        Args:
+            result: Result object
+        """
+        super().__init__()
+        self.encoding = result.encoding
+        self.xml_version = result.xml_version
+        self.xmlns = result.xmlns
+        self.xml_lang = result.xml_lang
+        self.status = result.status
+        self.message = result.message
+        self.title = result.title
+        self.link = result.link
+        self.id = result.id
+        self.servicecd = result.servicecd
+        self.updated = result.updated
+        self.total_results = result.total_results
+        self.start_index = result.start_index
+        self.items_per_page = result.items_per_page
+        self.entries_temp = result.entries
+        self.entries = []
+
+        for e in self.entries_temp:
+            ent = ListEntry()
+            ent.vols_title = _lang_dict(e.find('./vols_title', self.xmlns), self.xmlns)
+            ent.vols_link = _lang_dict(e.find('./vols_link', self.xmlns), self.xmlns)
+            ent.issn = _safe_text(e.find('./prism:issn', self.xmlns))
+            ent.eissn = _safe_text(e.find('./prism:eIssn', self.xmlns))
+            ent.publisher_name = _lang_dict(e.find('./publisher/name', self.xmlns), self.xmlns)
+            ent.publisher_url = _lang_dict(e.find('./publisher/url', self.xmlns), self.xmlns)
+            ent.cdjournal = _safe_text(e.find('./cdjournal', self.xmlns))
+            ent.material_title = _lang_dict(e.find('./material_title', self.xmlns), self.xmlns)
+            ent.volume = _safe_int(e.find('./prism:volume', self.xmlns))
+            ent.number = _safe_int(e.find('./prism:number', self.xmlns))
+            ent.starting_page = _safe_int(e.find('./prism:startingPage', self.xmlns))
+            ent.pubyear = _safe_text(e.find('./pubyear', self.xmlns))
+            ent.systemcode = _safe_int(e.find('./systemcode', self.xmlns))
+            ent.systemname = _safe_text(e.find('./systemname', self.xmlns))
+            ent.title = _safe_text(e.find('./title', self.xmlns))
+            link_el = e.find('./link', self.xmlns)
+            ent.link = (link_el.attrib.get('href', '').replace('\n', '').strip()) if link_el is not None else ''
+            ent.id = _safe_text(e.find('./id', self.xmlns))
+            updated_text = _safe_text(e.find('./updated', self.xmlns))
+            ent.updated = datetime.fromisoformat(updated_text) if updated_text else None
+            self.entries.append(ent)
+        self._finish_setup()

pyjstage/service.py

@@ -0,0 +1,11 @@
+from enum import Enum
+
+
+class Service(Enum):
+    """Enum for Services
+
+    Service.LIST: 巻号一覧取得
+    Service.SEARCH: 論文検索結果取得
+    """
+    LIST = 2
+    SEARCH = 3

pyjstage/status.py

@@ -0,0 +1,83 @@
+from . import errors
+from typing import Optional
+from enum import Enum
+
+
+class Status(Enum):
+    """Enum for Status
+
+    Status.OK: No Error
+    Status.NO_RESULTS: No results found
+    Status.TOO_MANY_RESULTS: Too many results found
+    Status.TOO_MANY_REQUESTS: Too many requests were occurred
+    Status.INVALID_QUERY: Query is invalid
+    Status.EMPTY_REQUIRED_FIELD: Any of required fields were not filled
+    Status.INVALID_YEAR_VALUE: Year value is invalid
+    Status.INVALID_COUNTS: Count value is invalid
+    Status.INVALID_ISSN: ISSN format is invalid.
+    Status.SYSTEM_FATAL: Fatal error has been occurred.
+    Status.INVALID_URL: URL is invalid
+    Status.LIST_NO_QUERY: Any of required queries were not sent.
+    Status.SEARCH_NO_QUERY: Any of required queries were not sent.
+    Status.LIST_UNSPECIFIED: Cannot specify result.
+    Status.SEARCH_UNSORTABLE: Cannot sort result.
+    """
+    OK = '0'
+    NO_RESULTS = 'ERR_001'
+    TOO_MANY_RESULTS = 'WARN_002'
+    TOO_MANY_REQUESTS = 'ERR_003'
+    INVALID_QUERY = 'ERR_004'
+    EMPTY_REQUIRED_FIELD = 'ERR_005'
+    INVALID_YEAR_VALUE = 'ERR_006'
+    INVALID_COUNTS = 'ERR_007'
+    INVALID_ISSN = 'ERR_008'
+    SYSTEM_FATAL = 'SYS_ERR_009'
+    INVALID_URL = 'ERR_010'
+    LIST_NO_QUERY = 'ERR_011'
+    SEARCH_NO_QUERY = 'ERR_012'
+    LIST_UNSPECIFIED = 'ERR_013'
+    SEARCH_UNSORTABLE = 'ERR_014'
+
+    @staticmethod
+    def divide(status: str, message: Optional[str]):
+        """Divide status and raise Error or Warning if necessary.
+
+        Args:
+            status: status code J-STAGE API returned
+            message: message J-STAGE API returned
+        Raises:
+            JstageError: error depending on j-stage api
+            JstageWarning: warning depending on j-stage api
+        """
+        if status == Status.OK.value:
+            pass
+        elif status == Status.NO_RESULTS.value:
+            raise errors.NoResultsError(message)
+        elif status == Status.TOO_MANY_RESULTS.value:
+            pass  # warning, not an error — API still returns valid data
+        elif status == Status.TOO_MANY_REQUESTS.value:
+            raise errors.TooManyRequestsError(message)
+        elif status == Status.INVALID_QUERY.value:
+            raise errors.InvalidQueryError(f'{message} invalid.')
+        elif status == Status.EMPTY_REQUIRED_FIELD.value:
+            raise errors.EmptyRequiredFieldError(f'{message} required.')
+        elif status == Status.INVALID_YEAR_VALUE.value:
+            raise errors.InvalidYearValueError(f'{message} invalid.')
+        elif status == Status.INVALID_COUNTS.value:
+            raise errors.InvalidCountsError(f'{message} invalid')
+        elif status == Status.INVALID_ISSN.value:
+            raise errors.InvalidIssnError(f'{message} invalid')
+        elif status == Status.SYSTEM_FATAL.value:
+            raise errors.SystemFatalError(message)
+        elif status == Status.INVALID_URL.value:
+            raise errors.InvalidUrlError(message)
+        elif status == Status.LIST_NO_QUERY.value:
+            raise errors.ListNoQueryError(f'{message} required')
+        elif status == Status.SEARCH_NO_QUERY.value:
+            raise errors.SearchNoQueryError(f'{message}: any parameter is required')
+        elif status == Status.LIST_UNSPECIFIED.value:
+            raise errors.ListUnspecifiedError(message)
+        elif status == Status.SEARCH_UNSORTABLE.value:
+            raise errors.SearchUnsortableError(message)
+        else:
+            raise Exception(message)

pyjstage2-0.1.2.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: pyjstage2
+Version: 0.1.2
+Summary: J-STAGE API wrapper for Python - Python 3.12 Compatible
+Home-page: https://github.com/lanshi17/pyjstage
+Author: lanshi17
+Author-email: lanshi17@users.noreply.github.com
+License: MIT
+Project-URL: Source, https://github.com/lanshi17/pyjstage
+Project-URL: Original, https://github.com/matsurih/pyjstage
+Keywords: jstage api wrapper japan science technology academic papers
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi>=2023.0.0
+Requires-Dist: chardet>=5.0.0
+Requires-Dist: idna>=3.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: urllib3>=2.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# pyjstage2
+
+![Python 3.12](https://img.shields.io/badge/python-3.12-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+![PyPI version](https://img.shields.io/pypi/v/pyjstage2)
+
+## Overview
+
+[J-STAGE WebAPI](https://www.jstage.jst.go.jp/static/pages/OtherJstageServices/TAB2/-char/ja) Wrapper for Python 3.
+
+- J-STAGE is an electronic journal platform for science and technology information in Japan, developed and managed by the Japan Science and Technology Agency (JST).
+- This package is a **Python 3.12 compatible fork** of [pyjstage](https://pypi.org/project/pyjstage/).
+
+## Acknowledgments
+
+This project is modified based on [matsurih/pyjstage](https://github.com/matsurih/pyjstage) (v0.0.2).
+
+Special thanks to the original author [@matsurih](https://github.com/matsurih) for creating this useful J-STAGE API wrapper.
+
+## What's Changed
+
+| Package | Original | Forked |
+|---------|----------|--------|
+| lxml | 4.4.2 | >=5.0.0 |
+| requests | 2.22.0 | >=2.31.0 |
+| urllib3 | 1.25.7 | >=2.0.0 |
+| certifi | 2019.11.28 | >=2023.0.0 |
+
+- Fixed absolute imports to relative imports
+- Fixed private method name mangling (`__finish_setup` → `_finish_setup`)
+- Added `__init__.py` export for cleaner imports
+
+## Prerequisites
+
+- Python >= 3.12
+
+## Installation
+
+```shell
+$ pip install pyjstage2
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from pyjstage.pyjstage import Pyjstage
+
+jstage = Pyjstage()
+
+# Search by ISSN
+ret_search = jstage.search(issn='2186-6619', count=3)
+
+# List articles in a journal
+ret_list = jstage.list(issn='2186-6619')
+```
+
+### Accessing Results
+
+```python
+for entry in ret_search.entries:
+    print(f"Title: {entry.title}")
+    print(f"Author: {entry.author.get('ja', '')}")
+    print(f"Journal: {entry.material_title.get('ja', '')}")
+    print(f"Year: {entry.pubyear}")
+    print(f"DOI: {entry.doi}")
+    print(f"Link: {entry.link}")
+```
+
+### Search Parameters
+
+```python
+jstage.search(
+    pubyearfrom=2020,      # Search from year
+    pubyearto=2024,        # Search to year
+    material='journal',    # Journal name contains
+    article='title',       # Article title contains
+    author='name',         # Author name contains
+    keyword='AI',          # Keyword contains
+    issn='2186-6619',      # ISSN
+    count=10               # Number of results (max 1000)
+)
+```
+
+## Important Notes
+
+### What J-STAGE API Provides
+
+- ✅ **Literature search** - Search by ISSN, keyword, author, year, etc.
+- ✅ **Metadata** - Title, author, journal, year, DOI, page numbers
+- ✅ **Article links** - Links to J-STAGE article pages
+
+### What J-STAGE API Does NOT Provide
+
+- ❌ **Full-text PDF download** - The API does not provide direct PDF downloads
+- ❌ **Full-text content** - The API returns metadata, not full article text
+
+To access full-text content, use the `link` or `doi` fields to visit the publisher's website.
+
+## Changelog
+
+### v0.1.2 (2025-06-16)
+
+- **Fix**: Null-safe XML parsing in `SearchResult` and `ListResult` — handles missing/empty XML elements without raising `AttributeError`
+- **Fix**: `WARN_002` (too many results) is now treated as a warning instead of raising an error, since the API still returns valid data
+
+### v0.1.1 (2025-05-18)
+
+- First PyPI release as `pyjstage2`
+- Python 3.12 compatibility
+- Updated dependencies (lxml >=5.0, requests >=2.31, urllib3 >=2.0)
+
+## Source Code
+
+https://github.com/lanshi17/pyjstage
+
+## License
+
+MIT License - see [LICENSE](https://github.com/lanshi17/pyjstage/blob/master/LICENSE) file.

pyjstage2-0.1.2.dist-info/RECORD

@@ -0,0 +1,14 @@
+pyjstage/__init__.py,sha256=_voPoelPe0YSf28fEqdfvw_70a66N4lNDXrOP3Tkz2M,31
+pyjstage/entry.py,sha256=qWcBP9_RdW6DtDE6wYHOBJ23Hh2VXiXn6DKXIsIhuZo,1963
+pyjstage/errors.py,sha256=b-GLUBz0DNpxYu8PwfmIAibNJh5akrekMvD5EvkntIQ,1159
+pyjstage/order.py,sha256=rUo9-voGrNSQwsG-VkTMG4wjxRBjVEGiH_FuUpfaTKk,392
+pyjstage/parser.py,sha256=owE829b1d_RWlSK8yu-kv8SIHc4nwM-TuWCkDbRBoxU,2464
+pyjstage/pyjstage.py,sha256=YMsb_UpAGbc7SRzgn5ZV1Hykd9aNskmVfTuXqhr65Io,5613
+pyjstage/result.py,sha256=0e_NUxSwRx9NHqO9SYuVAfko2j-T1gHtVNdO-5DudSg,9554
+pyjstage/service.py,sha256=S_Hg2hl6ac5X65UKhKyVByvE2UaoH_t_FdQuwGc2vL4,189
+pyjstage/status.py,sha256=3RVlTxx50UbKNpRKiXZHn05HwdDOeE_7QQ4gWLldoRQ,3481
+pyjstage2-0.1.2.dist-info/licenses/LICENSE,sha256=dqxSbI5Cx4e5NDbJ5PM-HCfO3UqN4DaoHD5xjMndkYU,1065
+pyjstage2-0.1.2.dist-info/METADATA,sha256=vBZMzK6IBfmDm1wxwfI5-_qgfZVYTdR-pd7vurTj4fg,4773
+pyjstage2-0.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pyjstage2-0.1.2.dist-info/top_level.txt,sha256=FbjfZZ2LZ-Y5Gm9sNRTUmxImh4QEhNblt_C0WESxgS8,9
+pyjstage2-0.1.2.dist-info/RECORD,,

pyjstage2-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyjstage2-0.1.2.dist-info/licenses/LICENSE

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

pyjstage2-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyjstage